Skip to main content

Retags a Container in a Container Registry without the need for Docker

Project description

Tagbot

Tagbot retags OCI Container Images without needing a full Docker Pull / Docker Push workflow by working directly with the registry API.

Usage

Local Usage

tagbot \
    --username example \
    --password password \
    --source example.azurecr.io/debian:latest \
    --tags v1.0.0,1.0.0

This would add an additional tag of v1.0.0 to example.azurecr.io/debian:latest. The container image can then be pulled with either example.azurecr.io/debian:latest, example.azurecr.io/debian:v1.0.0, or example.azurecr.io/debian:1.0.0

GitHub Actions Usage

name: release

on:
  push:
    tags: ["v[0-9]+.[0-9]+.[0-9]+"]

jobs:
  release:
    uses: binkhq/tagbot/.github/workflows/retag.yaml@master
    with:
      username: example
      source: example.azurecr.io/${{ github.event.repository.name }}:${{ github.ref_name }}
      tags: ${{ matrix.environment }}-v1.0.0,${{ matrix.environment }}
      envirnment:  ${{ matrix.environment }}
    secrets:
      password: ${{ secrets.ACR_BINKCORE_PASSWORD }}
    strategy:
      matrix:
        environment: [staging, production]

FAQ

  • Whats going on with ghcr.io/binkhq/tagbot?
    • This still exists, but is formally deprecated and will no longer recieve updates or support
  • Are Registries other than Azure Container Registry supported?
    • Azure Container Registry is the only officially supported Registry, but other simple registries like Docker Hub are expected to work just fine.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

container_tagbot-3.1.0.tar.gz (3.0 kB view hashes)

Uploaded Source

Built Distribution

container_tagbot-3.1.0-py3-none-any.whl (3.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page