google-github-actions/Cloud Storage Uploader

Upload files or folders to GCS buckets

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit May 26, 2026
License: Apache 2.0

Pinned Snippet

workflow.ymlSHA-pinned

uses: google-github-actions/upload-cloud-storage@6397bd7208e18d13ba2619ee21b9873edc94427a # v3.0.0

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
project_id	Google Cloud project ID to use for billing and API requests. If not provided, the project will be inferred from the environment, best-effort. To explicitly set the value: ```yaml project_id: 'my-project' ```	no	—
universe	The Google Cloud universe to use for constructing API endpoints. Trusted Partner Cloud and Google Distributed Hosted Cloud should set this to their universe address. You can also override individual API endpoints by setting the environment variable `GHA_ENDPOINT_OVERRIDE_<endpoint>` where `<endpoint>` is the API endpoint to override. For example: ```yaml env: GHA_ENDPOINT_OVERRIDE_oauth2: 'https://oauth2.myapi.endpoint/v1' ``` For more information about universes, see the Google Cloud documentation.	no	googleapis.com
path	The path to a file or folder inside the action's filesystem that should be uploaded to the bucket. You can specify either the absolute path or the relative path from the action: ```yaml path: '/path/to/file' ``` ```yaml path: '../path/to/file' ```	yes	—
destination	The destination for the file/folder in the form bucket-name or with an optional prefix in the form `bucket-name/prefix`. For example, to upload a file named `file` to the GCS bucket `bucket-name`: ```yaml destination: 'bucket-name' ``` To upload to a subfolder: ```yaml destination: 'bucket-name/prefix' ```	yes	—
gzip	Upload file(s) with gzip content encoding. To disable gzip content-encoding, set the value to false: ```yaml gzip: false ```	no	true
resumable	Enable resumable uploads. To disable resumable uploads, set the value to false: ```yaml resumable: false ```	no	true
predefinedAcl	Apply a predefined set of access controls to the files being uploaded. For example, to grant project team members access to the uploaded files according to their roles: ```yaml predefinedAcl: 'projectPrivate' ``` Acceptable values are: `authenticatedRead`, `bucketOwnerFullControl`, `bucketOwnerRead`, `private`, `projectPrivate`, `publicRead`. See [the document](https://googleapis.dev/nodejs/storage/latest/global.html#UploadOptions) for details.	no	—
headers	Set object metadata. For example, to set the `Content-Type` header to `application/json` and custom metadata with key `custom-field` and value `custom-value`: ```yaml headers: \|- content-type: 'application/json' x-goog-meta-custom-field: 'custom-value' ``` Settable fields are: `cache-control`, `content-disposition`, `content-encoding`, `content-language`, `content-type`, `custom-time`. See [the document](https://docs.cloud.google.com/storage/docs/metadata) for details. All custom metadata fields must be prefixed with `x-goog-meta-`.	no	—
parent	Whether the parent directory should be included in GCS destination path. To disable this: ```yaml parent: false ```	no	true
glob	Glob pattern to match for files to upload. ```yaml glob: '*.txt' ```	no	—
concurrency	Number of files to simultaneously upload. ```yaml concurrency: '10' ```	no	100
gcloudignore_path	Path to a gcloudignore file within the repository. ```yaml gcloudignore_path: '.gcloudignore.dev' ```	no	.gcloudignore
process_gcloudignore	Process a `.gcloudignore` file present in the top-level of the repository. If true, the file is parsed and any filepaths that match are not uploaded to the storage bucket. To disable, set the value to false: ```yaml process_gcloudignore: false ```	no	true

Outputs

name	description
uploaded	Comma-separated list of files that were uploaded.