Simple extension for the docker/github-actions for able to support default GCR authentication in self-hosted runners.

!!! Some default values overwritten by the repository. !!!

Inputs

• repository
• cmd
• username
• password
• registry
• tags
• tag_with_ref
• tag_with_sha
• path
• dockerfile
• target
• always_pull
• build_args
• cache_froms
• labels
• add_git_labels
• push

Example usage

Required Docker repository to tag the image with.

commands to run( build-push | build | push ). If not set then will default to build-push.

Username used to log in to a Docker registry. If not set then no login will occur.

Password or personal access token used to log in to a Docker registry. If not set then no login will occur.

Server address of Docker registry. If not set then will default to eu.gcr.io.

Comma-delimited list of tags. These will be added to the registry/repository to form the image's tags.

Example:

tags: tag1,tag2

Boolean value. Defaults to true.

Automatically tags the built image with the git reference. The format of the tag depends on the type of git reference with all forward slashes replaced with -.

For pushes to a branch the reference will be refs/heads/{branch-name} and the tag will be {branch-name}. If {branch-name} is master then the tag will be latest.

For pull requests the reference will be refs/pull/{pull-request} and the tag will be pr-{pull-request}.

For git tags the reference will be refs/tags/{git-tag} and the tag will be {git-tag}.

Examples:

Boolean value. Defaults to true.

Automatically tags the built image with the git short SHA prefixed with sha-.

Example:

Path to run the docker build from. Defaults to ..

Name of the Dockerfile. Defaults to {path}/Dockerfile.

Sets the target stage to build.

Boolean value. Defaults to true.

Always attempt to pull a newer version of the image.

Comma-delimited list of build-time variables.

Example:

build_args: arg1=value1,arg2=value2

Comma-delimited list of images to consider as cache sources.

Example:

cache_froms: myorg/baseimage:latest

Comma-delimited list of labels to add to the built image.

Example:

labels: label_name_1=label_value_1,label_name_2=label_value_2

Boolean value. Defaults to true.

Adds labels with git repository information to the built image based on the standards set out in https://github.com/opencontainers/image-spec/blob/master/annotations.md.

The labels are:

Boolean value. Defaults to true.

Whether to push the built image.

The following will build the root Dockerfile, tag the image as myorg/myrepository:latest, log in to Docker Hub using GitHub secrets, and push the image to the Docker Hub repository myorg/myrepository:

uses: aweris/gcr-docker-action@v1
with:
  repository: myorg/myrepository
  tags: latest

The following will build the root Dockerfile, tag the image with the git reference and SHA as described above, log in to Docker Hub using GitHub secrets, and push the image to the Docker Hub repository myorg/myrepository:

uses: aweris/gcr-docker-action@v1
with:
  repository: myorg/myrepository
  tag_with_ref: true
  tag_with_sha: true

The following will only push the image when the event that kicked off the workflow was a push of a git tag:

uses: aweris/gcr-docker-action@v1
with:
  repository: myorg/myrepository
  tag_with_ref: true
  push: ${{ startsWith(github.ref, 'refs/tags/') }}

The following builds the mytarget stage and pushes that:

uses: aweris/gcr-docker-action@v1
with:
  repository: myorg/myrepository
  tag_with_ref: true
  target: mytarget

• docker/github-actions
• docker/build-push-action