Docker

Important Principles ⭐#

Modification Prohibited (Mandatory): Any files under skill-docker. This skill is maintained via openclaw skills update skill-docker; any alterations will disrupt its normal operation.

skill-docker:interface-01 - Manifest Inspect#

bash

result=$(DOCKER_IMAGE=<DOCKER_IMAGE> DOCKER_TAGS=(<DOCKER_TAG1> [<DOCKER_TAG2> ...]) bash scripts/docker_manifest_inspect.sh)

Input value#

• DOCKER_IMAGE: Required, docker image name
• DOCKER_TAGS: Required, image tags array (e.g. DOCKER_TAGS=(1.0.0 latest))

Return value (result)#

Success: (sample only)

json

{
  "image": "debian",
  "tags": [
    {
      "tag": "latest",
      "exists": true,
      "archs": {
      }
    },
    {
      "tag": "latest",
      "exists": true,
      "archs": {
        "linux/amd64": {
          "size": 1021,
          "digest": "sha256:2477d9ee0ead4370c778ce3aa42258a0b07684d1a84ded8f4af518383fbc3f2d"
        },
        "linux/arm64/v8": {
          "size": 1041,
          "digest": "sha256:b1e30180b5678df3c17d6b0e659f7107ae4c299506e97427a9373640804db927"
        },
        ...
      }
    }
  ]
}

Error: (sample only)

• ERROR: Usage: DOCKER_IMAGE=<DOCKER_IMAGE> DOCKER_TAGS=(<TAG1> [<TAG2> ...]) scripts/docker_manifest_inspect.sh
• ERROR: authentication required or image('$DOCKER_IMAGE') not found

skill-docker:interface-02 - Build Init#

bash

result=$(DOCKER_BUILDER_NAME=<DOCKER_BUILDER_NAME> DOCKER_BUILD_CONCURRENCY=<DOCKER_BUILD_CONCURRENCY> DOCKER_PRUNE_FIRST=<DOCKER_PRUNE_FIRST> bash scripts/docker_buildx_init.sh)

Input value#

• DOCKER_BUILDER_NAME: Required, builder name to init (via env)
• DOCKER_BUILD_CONCURRENCY: Optional, max parallelism (default: 2)
• DOCKER_PRUNE_FIRST: Optional, remove all build cache (including internal/frontend images) (default: false)

Return value (result)#

Success: (sample only)

• SUCCESS: initted

skill-docker:interface-03 - Build Destroy#

bash

result=$(DOCKER_BUILDER_NAME=<DOCKER_BUILDER_NAME> DOCKER_PRUNE_FIRST=<DOCKER_PRUNE_FIRST> bash scripts/docker_buildx_destroy.sh)

Input value#

• DOCKER_BUILDER_NAME: Required, builder name to destroy (via env)
• DOCKER_PRUNE_FIRST: Optional, remove all build cache (including internal/frontend images) (default: false)

Return value (result)#

Success: (sample only)

• SUCCESS: destroyed

skill-docker:interface-04 - Build and Push#

skill-docker:step-0401#

If the DOCKER_BUILDER_NAME is not provided, ask user with "Confirm to use docker builder 'skilldockerbuilder' ?" to obtain the value, then assign the value to variable DOCKER_BUILDER_NAME . Then ask user with "Confirm to remove all build cache (including internal/frontend images) ?", then assign the value to variable DOCKER_PRUNE_FIRST

skill-docker:step-0402#

Call skill-docker:interface-02 to initialize builder with DOCKER_BUILDER_NAME=variable __DOCKER_BUILDER_NAME__ and with DOCKER_PRUNE_FIRST=__DOCKER_PRUNE_FIRST__.

skill-docker:step-0403#

Run build and push

bash

result=$(DOCKER_BUILDER_NAME=<DOCKER_BUILDER_NAME> DOCKER_PLATFORM=<DOCKER_PLATFORM> DOCKER_PROVENANCE=<DOCKER_PROVENANCE> DOCKER_SBOM=<DOCKER_SBOM> \
  DOCKER_IMAGE_TAGS=(<IMAGE_TAG1> [<IMAGE_TAG2> ...]) DOCKER_BUILD_ARGS=(<BUILD_ARG1> [<BUILD_ARG2> ...]) bash scripts/docker_buildx_push.sh)

Input value

• DOCKER_BUILDER_NAME: Fixed, via variable __DOCKER_BUILDER_NAME__
• DOCKER_PLATFORM: Required, target platforms separated by comma (e.g. linux/amd64,linux/arm64)
• DOCKER_IMAGE_TAGS: Required, image tags array (e.g. TAGS=(myimage:1.0.0 myimage:latest))
• DOCKER_BUILD_ARGS: Optional, build arguments array (e.g. BUILD_ARGS=(BUILD_ARG1=val1 BUILD_ARG2=val2))
• DOCKER_PROVENANCE: Optional, enable provenance attestation (default: false)
• DOCKER_SBOM: Optional, enable SBOM attestation (default: false)

Return value (result)

Success: (sample only)

• SUCCESS: Build and push completed successfully

Error: (sample only)

• ERROR: DOCKER_BUILDER_NAME is required. Usage: DOCKER_BUILDER_NAME=<DOCKER_BUILDER_NAME> DOCKER_PLATFORM=<DOCKER_PLATFORM> DOCKER_IMAGE_TAGS=<DOCKER_IMAGE_TAGS> $0
• ERROR: DOCKER_PLATFORM is required. Usage: DOCKER_BUILDER_NAME=<DOCKER_BUILDER_NAME> DOCKER_PLATFORM=<DOCKER_PLATFORM> DOCKER_IMAGE_TAGS=<DOCKER_IMAGE_TAGS> $0
• ERROR: At least one tag must be provided via DOCKER_IMAGE_TAGS environment variable. Usage: DOCKER_BUILDER_NAME=<DOCKER_BUILDER_NAME> DOCKER_PLATFORM=<DOCKER_PLATFORM> DOCKER_IMAGE_TAGS=<DOCKER_IMAGE_TAGS> $0

skill-docker:step-0404#

Call skill-docker:interface-03 to destroy builder with DOCKER_BUILDER_NAME=variable __DOCKER_BUILDER_NAME__ and with DOCKER_PRUNE_FIRST=__DOCKER_PRUNE_FIRST__.

More skills#

https://github.com/lentiancn/skills