Sign inSign up

projectnebula/ecs-deployer

By projectnebula

•Updated over 6 years ago

The ECS deployer task deploys containers to ECS clusters in AWS.

Image
0

2.9K

projectnebula/ecs-deployer repository overview

⁠AWS ECS deployer

This ECS deployer step container deploys containers to Elastic Container Service (ECS) clusters in AWS.

Before you use this workflow, make sure you've defined a set of ECS task definitions and added them to a directory in your repository. For more information, see Task Definitions⁠.

⁠Specifications

SettingChild settingData typeDescriptionDefaultRequired
pathstringThe path to the ECS task definitions in your repo.NoneTrue
clustermappingA map of ECS cluster configurations.NoneTrue
namestringA name for the cluster.NoneTrue
regionstringA region for the cluster.NoneTrue
credentialsmappingA map of platform credentials.NoneTrue
credentialsmappingThe AWS shared account file contents. Pass the file contents into Nebula as a secret. See the example below.NoneTrue for aws
gitmappingA map of git configuration. If you're using HTTPS, only name and repository are required.NoneFalse
ssh_keystringThe SSH key to use when cloning the git repository. You can pass the key to Nebula as a secret. See the example below.NoneTrue
known_hostsstringSSH known hosts file. Use a Nebula secret to pass the contents of the file into the workflow as a base64-encoded string. See the example below.NoneTrue
namestringA directory name for the git clone.NoneTrue
branchstringThe Git branch to clone.masterFalse
repositorystringThe git repository URL.NoneTrue

Note: The value you set for a secret must be a string. If you have multiple key-value pairs to pass into the secret, or your secret is the contents of a file, you must encode the values using base64 encoding, and use the encoded string as the secret value.

⁠Examples

Here is an example of the step in a Nebula workflow:

steps:

...

- name: ecs-deployer
  image: projectnebula/ecs-deployer:latest
  spec:
    path: workspaces/aws
    cluster: 
      name: my-cluster
      region: us-west-2
    credentials:
      credentials: 
        $type: Secret
        name: credentials
    git: 
      ssh_key:
        $type: Secret
        name: ssh_key
      known_hosts:
        $type: Secret
        name: known_hosts
      name: my-git-repo
      branch: dev
      repository: path/to/your/repo

For more information about ECS clusters, see Creating a Cluster with a Fargate Task Using the Amazon ECS CLI⁠.

Tag summary

Content type

Image

Digest

Size

31.7 MB

Last updated

over 6 years ago

docker pull projectnebula/ecs-deployer