Sign inSign up

cisagov/con-pca-tasks

By cisagov

•Updated over 3 years ago

Image
0

1.7K

cisagov/con-pca-tasks repository overview

⁠Con-PCA Tasks Docker 🐳

GitHub Build Status CodeQL Known Vulnerabilities

⁠Docker Image

Docker Pulls Docker Image Size (latest by date) Platforms

This project's purpose is to containerize Con-PCA-Tasks⁠ project as part of our CI/CD pipeline.

⁠Running

⁠Running with Docker Compose
  1. Start the container and detach:

    docker compose up --detach
    

⁠Updating your container

⁠Docker Compose
  1. Pull the new image from Docker Hub:

    docker compose pull
    
  2. Recreate the running container by following the previous instructions⁠:

    docker compose up --detach
    

⁠Image tags

The images of this container are tagged with semantic versions⁠ of the underlying con-pca-tasks project that they containerize. It is recommended that most users use a version tag (e.g. :0.0.1).

Image:tagDescription
cisagov/con-pca-tasks:0.0.1An exact release version.
cisagov/con-pca-tasks:0.0The most recent release matching the major and minor version numbers.
cisagov/con-pca-tasks:0The most recent release matching the major version number.
cisagov/con-pca-tasks:edgeThe most recent image built from a merge into the develop branch of this repository.
cisagov/con-pca-tasks:nightlyA nightly build of the develop branch of this repository.
cisagov/con-pca-tasks:latestThe most recent release image pushed to a container registry. Pulling an image using the :latest tag should be avoided.⁠

See the tags tab⁠ on Docker Hub for a list of all the supported tags.

⁠Volumes

Mount pointPurpose
/var/logLog storage

⁠Ports

The following ports are exposed by this container:

PortPurpose
8080REST API to manage tasks and trigger the sending of emails

⁠Environment variables

⁠Required
NamePurposeDefault
AWS_ACCESS_KEY_IDAWS Access IDnull
AWS_SECRET_ACCESS_KEYAWS Access Secretnull
AWS_DEFAULT_REGIONAWS Access Keyus-east-1

⁠Building from source

Build the image locally using this git repository as the build context⁠:

docker build \
  --build-arg VERSION=0.0.1 \
  --tag cisagov/con-pca-tasks:0.0.1 \
  https://github.com/cisagov/con-pca-tasks-docker.git#develop

⁠Cross-platform builds

To create images that are compatible with other platforms, you can use the buildx⁠ feature of Docker:

  1. Copy the project to your machine using the Code button above or the command line:

    git clone https://github.com/cisagov/con-pca-tasks-docker.git
    cd con-pca-tasks-docker
    
  2. Create the Dockerfile-x file with buildx platform support:

    ./buildx-dockerfile.sh
    
  3. Build the image using buildx:

    docker buildx build \
      --file Dockerfile-x \
      --platform linux/amd64 \
      --build-arg VERSION=0.0.1 \
      --output type=docker \
      --tag cisagov/con-pca-tasks:0.0.1 .
    

⁠Contributing

We welcome contributions! Please see CONTRIBUTING.md⁠ for details.

⁠License

This project is in the worldwide public domain⁠.

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication⁠.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

Tag summary

Content type

Image

Digest

sha256:81681d5ba…

Size

31.2 MB

Last updated

over 3 years ago

docker pull cisagov/con-pca-tasks:nightly