From e51494eee3eae47f6b2f77da1cca8eaaa3abf9a5 Mon Sep 17 00:00:00 2001 From: rvandernoort Date: Tue, 30 Sep 2025 17:49:33 +0200 Subject: [PATCH 1/4] Update crane.md Signed-off-by: rvandernoort --- pages/common/crane.md | 32 ++++++++++++++++++++------------ 1 file changed, 20 insertions(+), 12 deletions(-) diff --git a/pages/common/crane.md b/pages/common/crane.md index 1638a8c8c1e33b..97a8576c8f0d8a 100644 --- a/pages/common/crane.md +++ b/pages/common/crane.md @@ -4,26 +4,34 @@ > Some subcommands such as `pull`, `push`, `copy`, etc. have their own usage documentation. > More information: . -- Execute a `crane` subcommand: +- Build or pull images if they don't exists: -`crane {{subcommand}}` +`crane up/lift {{[-d|--detach]}}` -- Allow pushing non-distributable (foreign) layers: +- Start stopped container: -`crane --allow-nondistributable-artifacts {{subcommand}}` +`crane start {{target}}` -- Allow image references to be fetched without TLS: +- Stop running containers: -`crane --insecure {{subcommand}}` +`crane stop {{target}}` -- Specify the platform in the form os/arch{{/variant}}{{:osversion}} (e.g. linux/amd64). (default all): +- Execute command in target container: -`crane --platform {{platform}} {{subcommand}}` +`crane exec {{target}} {{}}` -- Enable debug logs for a subcommand: +- Remove stopped container: -`crane {{-v|--verbose}} {{subcommand}}` +`crane rm {{[-f|--force]}} {{target}}` -- Display help for a subcommand: +- Push containers to the regsitry: -`crane {{-h|--help}} {{subcommand}}` +`crane push {{target}}` + +- Show container logs: + +`crane logs {{target}}` + +- Show container statuses: + +`crane status` From 4a400053bde245971ce74782a0160fd5c7b3068b Mon Sep 17 00:00:00 2001 From: rvandernoort Date: Wed, 1 Oct 2025 10:00:19 +0200 Subject: [PATCH 2/4] Fix crane page completely Signed-off-by: rvandernoort --- pages/common/crane.md | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/pages/common/crane.md b/pages/common/crane.md index 97a8576c8f0d8a..60bf977ed10b56 100644 --- a/pages/common/crane.md +++ b/pages/common/crane.md @@ -4,34 +4,34 @@ > Some subcommands such as `pull`, `push`, `copy`, etc. have their own usage documentation. > More information: . -- Build or pull images if they don't exists: +- Log in to a registry: -`crane up/lift {{[-d|--detach]}}` +`crane auth login {{registry}} -u {{user}} -p {{password}}` -- Start stopped container: +- List the repos in a registry: -`crane start {{target}}` +`crane catalog {{registry}} {{[--full-ref]}}` -- Stop running containers: +- List the tags in a repostiory: -`crane stop {{target}}` +`crane ls {{repository}} {{[-o|--omit-digest-tags]}}` -- Execute command in target container: +- Pull remote images by reference and store their contents locally: -`crane exec {{target}} {{}}` +`crane pull {{image}} {{tarball}}` -- Remove stopped container: +- Push local image contents to a remote registry: -`crane rm {{[-f|--force]}} {{target}}` +`crane push {{path}} {{image}}` -- Push containers to the regsitry: +- Efficiently tag a remote image: -`crane push {{target}}` +`crane tag {{image}} {{tag}}` -- Show container logs: +- Efficiently copy a remote image from src to dst while retaining the digest value: -`crane logs {{target}}` +`crane copy {{src}} {{dst}} {{[-a|-all-tags]}}` -- Show container statuses: +- Delete an image reference from its registry: -`crane status` +`crane delete {{image}}` From 9d6303dd6263291bb3bba3f8af36c38de3a25acf Mon Sep 17 00:00:00 2001 From: Rover van der Noort <33723189+rvandernoort@users.noreply.github.com> Date: Thu, 2 Oct 2025 10:46:28 +0200 Subject: [PATCH 3/4] Apply suggestions from code review Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/crane.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pages/common/crane.md b/pages/common/crane.md index 60bf977ed10b56..7d40a8cd837f79 100644 --- a/pages/common/crane.md +++ b/pages/common/crane.md @@ -6,13 +6,13 @@ - Log in to a registry: -`crane auth login {{registry}} -u {{user}} -p {{password}}` +`crane auth login {{registry}} {{[-u|--username]}} {{user}} {{[-p|--password]}} {{password}}` - List the repos in a registry: -`crane catalog {{registry}} {{[--full-ref]}}` +`crane catalog {{registry}} --full-ref` -- List the tags in a repostiory: +- List the tags in a repository: `crane ls {{repository}} {{[-o|--omit-digest-tags]}}` From 7f8ac1b12f393ee9c6f01eff7e8aeca90e2aef0c Mon Sep 17 00:00:00 2001 From: Rover van der Noort <33723189+rvandernoort@users.noreply.github.com> Date: Thu, 2 Oct 2025 11:08:52 +0200 Subject: [PATCH 4/4] Apply suggestions from code review Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/crane.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/common/crane.md b/pages/common/crane.md index 7d40a8cd837f79..56ab5e53bfbd23 100644 --- a/pages/common/crane.md +++ b/pages/common/crane.md @@ -22,7 +22,7 @@ - Push local image contents to a remote registry: -`crane push {{path}} {{image}}` +`crane push {{path/to/directory_or_tarball}} {{image}}` - Efficiently tag a remote image: @@ -30,7 +30,7 @@ - Efficiently copy a remote image from src to dst while retaining the digest value: -`crane copy {{src}} {{dst}} {{[-a|-all-tags]}}` +`crane copy {{src}} {{dst}} {{[-a|--all-tags]}}` - Delete an image reference from its registry: