kit-image-deployer

[DEPRECATED] Thanks for using this package, but we will no longer support it.

A service that can be used to update given yaml files within a git repository with a new docker image path. This can be used in colaboration with kit-deploymentizer and kit-deployer to automatically update the images used for a service across multiple clusters.

Use as Docker Image

docker run quay.io/invision/kit-image-deployer --help

We recommend using kit components with Codeship's Docker Infrastructure, however you are free to run this tool however way you wish. Anything that has Docker can run this image.

Using as CLI

You can run the ./src/image-deployer --help to see how it works.

Note this method requires node and was tested on version 5.5.0.

Using as npm module

Use npm to install kit-image-deployer:

$ npm install kit-image-deployer --save

Then require it and use it like so:

var ImageDeployer = require("kit-image-deployer").ImageDeployer;
var imageDeployer = new ImageDeployer({
    docker: {
        registry: "my-registry.com",
        repo: "example/my-service"
    },
    github: {
        token: "my-github-token-here"
        user: "chesleybrown",
        repo: "my-kube-repo"
    }
});
 
// Deploy by commit ID
imageDeployer.deployCommitId(
    "70c30b1b3a1fce1e6826700c31830f47521292ad",
    branch,
    {
        name: committerName,
        email: committerEmail
    },
    commitMessage,
    save)
    .then(console.log)
    .catch(console.error);
 
// OR deploy a full image name
imageDeployer.deployImage(
    "node:5.5.0",
    branch,
    {
        name: committerName,
        email: committerEmail
    },
    commitMessage,
    save)
    .then(console.log)
    .catch(console.error);

Configuration

The repository you are writing to should have a kit.yaml configuration file.

images:
  path: images
  property: image

• images.path is for specifying the directory path to where all your image yaml files will be stored
• images.property is the yaml property name within the given image files that will be updated with the image path

Expected environment variables

The following environment variables are used by this service.

Contributing

See the Contributing guide for steps on how to contribute to this project.

Todo:

• Handle automatic retries if github request fails because of sha difference