📟 A tool for fetching, building, pushing and deploying applications.

$ go get github.com/pagarme/deployer

deployer command [options] <path>

Commands:
  deploy    Deploy an application using a configuration file

Options:
  --ref     Source Code Management hash to be fetched (default: master)
  --env     Environment to be used (default: main)

To deploy an application you must specify a yml configuration file (e.g. deployer.yml), that consists in steps and environment configuration. A typical configuration file has the following structure:

scm:
  type: <type>

build:
  type: <type>

deploy:
  type: <type>

environments:
  sandbox:
    name: sandbox
  live:
    name: live

Note: The order the steps appear in the configuration file, does not determine the order they will be executed. Check Steps for more information.

The deployer deploys application executing different steps, one after the other. The order the steps are executed is: scm -> build -> deploy

Available types are: git.

The Git SCM Step clones a git repository with an specified hash and adds it to a temporary folder.

Options:

Example:

scm:
  type: git
  repository: https://github.com/pagarme/deployer
  ref: master

Available types are: rocker.

The Rocker Build step builds and pushes a specified Rockerfile. The following variables are injected when building the Rockerfile:

1. RepositoryPath: The location of the cloned repository from the SCM step
2. ImageSHA: The sha of the ref from the SCM step
3. ImageRepository: The repository where the Rocker image will be pushed

For more information about Rocker, check the official documentation (https://github.com/grammarly/rocker)

Options:

Example:

build:
  type: rocker
  build_directory: path/to
  image_repository: xxxxxx.dkr.ecr.us-east-1.amazonaws.com/deployer # Pushing the image to an AWS ECR

Available types are: lambda and nomad.

The Lambda Deploy step updates and deploys existing AWS Lambda functions. It creates a zip file, uploads it to a S3 Bucket and updates the Lambda functions code.

Note: This step does not create the AWS Lambda functions, but instead updates existing functions code.

Options:

Environment:

Example:

deploy:
  type: lambda
  region: us-east-1
  s3_bucket: pagarme-deploy-s3-bucket
  package: # This will create a zip containing the `dist` and the `node_modules` folders
    - dist
    - node_modules

environment:
  live:
    name: live
    functions:
      - hello
      - cowsay