Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Example specification:

Code Block
{
    "id": "uniqueid",
    "key": "cloud9gomykey",
    "label": "Cloud9 GOMy Service Display Name",
    "image": "ndslabs/cloud9-gomyimage:latest",
    "display": "stack",
    "access": "external",
    "description": "UnopinionatedDescription Goof development environment based on Cloud9my service",
    "ports": [
        {
            "port": 80,
            "protocol": "http"
        },
        {
            "port": 8000,
            "protocol": "http"
        },
        {
            "port": 8080,
            "protocol": "http"
        }
    ],
    "repositories":  [
        {
            "name": "https://github.com/golang/example",
            "type": "git"
        }
    ],
    "developerEnvironment" : "cloud9godevenvkey",
    "volumeMounts":[
       { "mountPath": "/workspace", "name": "cloud9go" }
    ],
    "readinessProbe" : {
        "type" : "http",
        "path" : "/favicon.ico",
        "port" : 80,
        "initialDelay": 10,
        "timeout" : 600
    },
    "resourceLimits": {
        "cpuMax": "1",
        "cpuDefault": "100m",
        "memMax": "2Gi",
        "memDefault": "1Gi"
    },
	"tags": [
		"Go", "Development Environment"
	]
}
Field

...

DescriptionNotes

...

idUnique IDUsed to uniquely identify this service
keyShort nameUsed in Kubernetes service, RC and pod names. Should be unique
labelDisplay name 
descriptionDescription 
imageDocker image 
dependenciesOptional and required depenciesShould key on ID going forward
display Do we need this?
access Should

...

this be at the spec or stack level?

...

portsList of ports exposed by this serviceCurrently, we assume a single port. Multiple ports means multiple NodePorts or ingress rules

...

.
repositoriesList of source code repositories associated with this serviceShould support Git/Bitbucket, Mercurial, SVN, CVS. A service can have multiple repositories. 

...

developerEnvironmentDeveloper environment used to create this serviceReference to unique ID of developer environment specification
volumeMountsList of volume mount pointsCurrently, we support a single volume mount
readinessProbeReadiness probe used to determine when the service is ready 
resourceLimitsResource limits for the service 
tagsList of tags used to describe/filter this serviceWhere do the tags come from

 

Other:

  • /tags: Get a list of valid tags
  • /services?filter=tag1,tag2,tag3