gcloud alpha topic gcloudignore - reference for.gcloudignore files

If there is a file called.gcloudignorewithin thetop-level directory being uploaded, the files that it specifies(see "SYNTAX") will be ignored.

Gcloud commands may generate a .gcloudignore file; see the individual commandhelp page for details.

The followinggcloud commandsrespect the.gcloudignore file:

• gcloud app deploy
  • Note: If you addapp.yaml to the.gcloudignore file,this command will fail.
• gcloud functionsdeploy
• gcloud buildssubmit
• gcloud composer environments storage {dags, data, plugins} import
• gcloud container builds submit
• gcloud run deploy
• gcloud run jobsdeploy
• gcloud alpha deploy releases create
• gcloudinfra-manager deployments apply
• gcloudinfra-manager previews create
• gcloud alphafunctions local deploy
• gcloud alpha runjobs deploy
• gcloud beta run jobsdeploy
• gcloud alpharun worker-pools deploy
• gcloud betarun worker-pools deploy

To globally disable.gcloudignore parsing (including defaultfile-ignore behavior), run:

gcloudconfigsetgcloudignore/enabledfalse

The default content of the generated.gcloudignore file, which canbe overridden with--ignore-file, is as follows:

.gcloudignore.git.gitignore

/node_modules/*~

This.gcloudignore (similar to the one generated when Git files arepresent) would prevent the upload of the.gcloudignore file, the.git directory, and any files in ignored in the.gitignore file:

.gcloudignore# If you would like to upload your .git directory, .gitignore file or# files from your .gitignore file, remove the corresponding line below:.git.gitignore#!include:.gitignore

Each line in a.gcloudignore is one of the following:

• pattern: a pattern specifies file names to ignore (or explicitlyinclude) in the upload. If multiple patterns match the file name, the lastmatching pattern takes precedence.
• comment: comments begin with# and are ignored (see"ADVANCED TOPICS" for an exception). If you want to include a# atthe beginning of a pattern, you must escape it:\#.
• blank line: A blank line is ignored and useful for readability.

Some example patterns follow; see the full reference (https://git-scm.com/docs/gitignoreorman gitignore) for details.

To ignore any file namedfoo, and any file in the root of theupload directory namedbar:

foo/bar

To ignore any file starting withfoo, ending withbar,or starting withbaz and ending withqux:

foo**barbaz*qux

To explicitly include any file namedfoo (useful iffoo was excluded earlier in the file) and ignore a file named!bar:

!foo\!bar

To ignore any directoryfoo and all its contents (though not a filefoo), any filebaz, and the directoryquxand all its contents:

foo/**/bazqux/**

#!include:.gitignore

This will insert the content of a.gitignore-style file named.gitignore at the point of the include line. It does not recurse(that is, the included filecannot#!include anotherfile) and cannot be anywhere but the top-level directory to be uploaded.

To display files that will be uploaded run:

gcloudmetalist-files-for-upload