From b1ab0337c08c6a0d9773b71fafd0e5fdd2c24981 Mon Sep 17 00:00:00 2001 From: "Vipul Gupta (@vipulgupta2048)" Date: Wed, 8 Jul 2020 13:51:56 +0530 Subject: [PATCH] Improve help description for --nocache option of `balena push` Change-type: patch Signed-off-by: Vipul Gupta (@vipulgupta2048) --- doc/cli.markdown | 6 +++++- lib/actions/push.ts | 7 ++++++- 2 files changed, 11 insertions(+), 2 deletions(-) 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, }, {