Breeds are static descriptions of applications and services available for deployment. Each breed is described by the DSL in YAML notation or JSON, whatever you like. This description includes name, version, available parameters, dependencies etc. To a certain degree, you could compare a breed to a Maven artifact or a Ruby Gem description. Vamp tracks all revisions made to artifacts, so you can check back and compare a current breed against a previous version.
Breeds allow you to set the following properties:
- Deployable: the name of actual container or command that should be run.
- Ports: a map of ports your container exposes.
- Dependencies: a list of other breeds this breed depends on.
- Environment variables: a list of variables (interpolated or not) to be made available at runtime.
- Health checks: a list of health checks to perform on this breed (note that these will be overridden by health checks defined on the service or cluster level)
The breeds listed below are required by system workflows and should not be deleted:
Deployables are pointers to the actual artifacts that get deployed. Vamp supports Docker containers or can support any other artifacts supported by your container manager.
Example breed - deploy a Docker container
--- name: my_breed:0.1 deployable: company/my_frontend_service:0.1 ports: web: 8080/http
This breed, with a unique name, describes a deployable and the port it works on.
Docker images are pulled by your container manager from any of the repositories configured. By default that would be the public Docker hub, but it could also be a private repo.
The default deployable type is a Docker container, but we could also make this explicit by setting type to
docker. The following statements are equivalent:
--- deployable: company/my_frontend_service:0.1
--- deployable: type: container/docker definition: company/my_frontend_service:0.1
This shows the full (expanded) deployable with
Breeds can have type
It is possible to create or update breeds with the API request
Other deployable types
Running “other” artifacts such as zips or jars heavily depends on the underlying container manager.
When Vamp is set up to run with Marathon (mesosphere.github.io - Marathon),
cmd) deployable types can be used.
In that case cmd (Marathon REST API - post v2/apps) parameter will have value of deployable.
Example breed - run a custom jar after it has been downloaded
Combining this definition and the Vamp Marathon dialect
uris parameter allows the requested jar to be downloaded from a remote location (Marathon REST API - uris Array of Strings).
--- name: location clusters: api: services: breed: name: location deployable: type: cmd definition: java -jar location.jar marathon: uris: ["https://my_repo_location_jar"]
ports property is an array of named ports together with their protocol. It describes on what ports the deployables is offering services to the outside world. Let’s look at the following breed:
--- name: my_breed:0.1 deployable: company/my_frontend_service:0.1 ports: web: 8080/http admin: 8081/http redis: 9023/tcp
Ports come in two flavors:
/httpHTTP ports are the default type if none is specified. They are always recommended when dealing with HTTP-based services. Vamp can record a lot of interesting metrics like response times, errors etc. Of course, using
/tcpwill work but you miss out on cool data.
/tcpUse TCP ports for things like Redis, MySQL etc.
/http notation for ports is required for use of filters.
Notice we can give the ports sensible names. This specific deployable has
web port for customer traffic, an
admin port for admin access and a
redis port for some caching probably. These names come in handy when we later compose different breeds in blueprints.
Breeds can also have dependencies on other breeds. These dependencies should be stated explicitly, similar to how you would do in a Maven pom.xml, a Ruby Gemfile or similar package dependency systems, i.e:
--- dependencies: cache: redis:1.1
It is also possible to use wildcard
* at the end of the name. This will match any breed name that starts with
--- dependencies: cache: redis:1.*
In a lot of cases, dependencies coexist with interpolated environment variables or constants because exact values are not known untill deploy time. Read more about environment variables
Last updated on September 28, 2018