Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Plugin Information

View Google Container Registry Auth on the plugin site for more information.

Google Container Registry Auth Plugin

This plugin provides the credential provider to use Google Cloud Platform OAuth Credentials (provided by the Google OAuth Credentials plugin) to access access Docker images from Google Container Registry.

Introduction

This plugin supports both kinds of credentials provided by Google OAuth Credentials plugin : Google Service Account from metadata as well as Google Service Account from private key.

As of this writing, this plugin can be used together with Docker Build Step Plugin. The latter plugin will be able to retrieve the credential provided by this plugin, and then use it to authenticate against Google Container Registry to pull/push Docker images. Other plugins that rely on credentials provider or Docker Commons Plugin to provide credentials will also be able to utilize this credential provider plugin.

Usage

The instruction below uses Docker Build Step Plugin as an example to show how this plugin can be used to provide credentials for the former plugin to authenticate against Google Container Registry to perform pull/push. It is possible to use this plugin with other plugins, if those plugins rely on credentials provider or Docker Commons Plugin to provide Google Container Registry credentials.

  • Install Docker Build Step Plugin, and configure it accordingly. Note that do not forget to configure its global configurations, which includes the Docker server's address.
  • Configure your OAuth credentials per instructions from Google OAuth Plugin, using the service account that has read/write access to your Google Container Registry.
  • Install this plugin, then on Jenkins' global configuration page, under "Google Container Registry", set the correct Google Container Registry server address. By default, it is "gcr.io,*.gcr.io" (Do not include schemes such as "https://").
  • In your Jenkins job, add a build step "Execute Docker Container", and choose either "pull image" or "Push image" as your docker command (other docker commands don't require credentials so they are not relevant to this plugin). Enter image name, tag and registry. In the "Registry Server Address" field, by default you should enter "https://gcr.io". The value in this field should match the value in "Google Container Registry" Server Address field in global configuration, but with the scheme (such as https://) added. Its exact value (the part after "https://") should be decided by the registry of your docker image.
  • In the "Docker Credential" dropdown, select your account marked as "Google Container Registry Account".
  • Save your configuration and run your job.

Version History

Version 0.1 (June 11, 2015)

  • Initial release
  • No labels