Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated docs to GitHub

This Google Cloud Storage Plugin provides functionality to communicate with Google Cloud Storage, as build steps, post-build steps, or pipeline steps.

Wiki Markup

Google Cloud Storage Plugin


This plugin provides functionality to communicate with Google Cloud Storage, as build steps, post-build steps, or pipeline steps.


All steps consume credentials surfaced by the Google OAuth Credentials plugin for authenticating storage requests.  Once you have register a credential (e.g. “my-project”) that provides storage access you will see:

Image Removed

If no suitable credentials are found, you will see:

Image Removed

In this case, you will need to set up credentials in the Credentials tab (see instructions for Google OAuth Credentials plugin).

Build step

Two build steps are supported by this plugin:

  • Classic Upload step to upload files to Google Storage, and
  • Download step to get files from Google Storage into the local Jenkins workspace.

Image Removed

Classic Upload Build Step

Image Removed

Use the Classic Upload Build Step to upload an ant-style glob of files (File Pattern) to the specified storage path (Storage Location). Select:

  • Share Publicly to make the uploaded files publicly accessible,
  • Show inline in browser to set the metadata of the files such that the file is shown inline in browser, rather than downloaded,
  • Strip path prefix and specify the prefix you want to strip if you don’t want the whole path of the local files reflected in the bucket object name.

Download Build Step

Image Removed

Use the Download step to download files (Object to download) from Cloud Storage into the local directory. The wildcards here act the same way as in GSUtil tool. Currently only a single asterisk at the lowest level of the object name is supported.

If you don't want the whole path of the object to be reflected in the directory structure, select Strip path prefix to strip a prefix from the object names.

Pipeline Step

Both Classic Upload and Download functionality are available through pipelines and can be generated with Pipeline Syntax builder.

Post-build step

Image Removed

This plugin provides the “Google Cloud Storage Uploader” post-build step for publishing build artifacts to Google Cloud Storage. Download functionality is not supported, but can be accessed as a Build Step (see above).

Configure the post-build step with any combination of the following sub-steps:

Bucket with expiring elements lifecycle

Use this step to set a time to live for a given Google Cloud Storage bucket. It will configure the named bucket to delete objects after the specified number of days.

Image Removed

Build log upload

Image Removed


This step uploads the contents of the Jenkins build log to the specified storage path.

To configure this operation to upload stdout even if the build fails, check "For failed jobs". To configure the operation to make the uploaded logs publicly accessible, check "Share publicly".

Classic upload

Classic Upload has the same functionality as the Build Step Classic Upload step. One additional option is "For failed jobs". Check this box to do the upload to Google Cloud Storage even if the build fails.

Image Removed

Consult the google-storage-plugin repository on GitHub for documentation.