diff --git a/doc/cli.markdown b/doc/cli.markdown index 8af5a3c4..d9e16680 100644 --- a/doc/cli.markdown +++ b/doc/cli.markdown @@ -2074,7 +2074,11 @@ Alternative Dockerfile name/path, relative to the source folder #### --nocache, -c -Don't use cache when building this project +Don't use cached layers of previously built images for this project. This ensures +that the latest base image and packages are pulled. Note that build logs may still +display the message _"Pulling previous images for caching purposes" (as the cloud +builder needs previous images to compute delta updates), but the logs will not +display the "Using cache" lines for each build step of a Dockerfile. #### --noparent-check diff --git a/lib/actions/push.ts b/lib/actions/push.ts index 8ae687d1..ba3b5fcf 100644 --- a/lib/actions/push.ts +++ b/lib/actions/push.ts @@ -192,7 +192,12 @@ export const push: CommandDefinition< { signature: 'nocache', alias: 'c', - description: "Don't use cache when building this project", + description: stripIndent` + Don't use cached layers of previously built images for this project. This ensures + that the latest base image and packages are pulled. Note that build logs may still + display the message _"Pulling previous images for caching purposes" (as the cloud + builder needs previous images to compute delta updates), but the logs will not + display the "Using cache" lines for each build step of a Dockerfile.`, boolean: true, }, {