# zix docker

Docker Hub のリポジトリ・タグ、公的一覧の観測と、確認した対象だけの削除計画。削除結果が不明なら読み取りで再確認します。 正式版 0.3.0。

## 1. インストールと有効化

初回はUbuntu 24.04以降相当のOS依存を準備してから、以下を実行します。ghの事前導入・GitHubログインは不要です。既に基盤がある場合は zix-setup install --with docker だけで追加できます。機能一覧は記載バージョン時点で、導入時には最新安定版を選びます。

```text
mkdir -p "$HOME/.local/share/zix/bootstrap"
chmod 700 "$HOME/.local/share/zix/bootstrap"
cd "$HOME/.local/share/zix/bootstrap"
curl --fail --location https://zixcel.com/install.sh -o install.sh
curl --fail --location https://zixcel.com/SHA256SUMS.installer -o SHA256SUMS.installer
sha256sum --check SHA256SUMS.installer
# Inspect install.sh before running.
bash install.sh install --with docker
export PATH="$HOME/.local/bin:$PATH"
zix-setup doctor
zix extensions inspect docker --format json
```

[対応OS・依存関係を先に準備](https://zixcel.com/ja/docs/setup)

[正式版を取得](https://github.com/zixcel/zixcel-container-registry/releases/tag/v0.3.0)

## 2. 具体的な機能一覧

Docker Hub のリポジトリ・タグ、公的一覧の観測と、確認した対象だけの削除計画。削除結果が不明なら読み取りで再確認します。 正式版 0.3.0。

```text
docker.list [read] — DOCKER REGISTRY READ: list selected namespace repositories
docker.get [read] — DOCKER REGISTRY READ: read selected repository metadata
docker.tags [read] — DOCKER REGISTRY READ: read selected repository tags
docker.verify-absent [read] — DOCKER REGISTRY READ: observe original targets absence
docker.delete-plan [read] — DOCKER REGISTRY PLAN: plan explicit repository retirement
docker.delete-apply [operator-write] — DOCKER RETIREMENT APPLY: apply reviewed one use retirement
docker.snapshot-collect [read] — DOCKER PUBLIC READ: collect bounded public registry snapshot
docker.snapshot-show [read] — DOCKER PUBLIC READ: read local public snapshot
docker.snapshot-diff [read] — DOCKER PUBLIC READ: compare local public snapshots
```

## 3. 入力と必要権限を確認

この確認は認証情報を読み取らず、外部APIも呼びません。1操作を選び、必須入力・対象・認証先・権限を確認してから実行します。

```text
zix capabilities --namespace docker --compact --format json
zix describe docker --operation docker.list --compact --format json
```

[操作と必要条件](https://github.com/zixcel/zixcel-container-registry/blob/main/docs/operation-guidance.md)

[認証情報の登録](https://zixcel.com/ja/docs/credentials)

## 4. 更新とエラー対応

更新には extensions replace を使い、新旧ハッシュを照合します。登録と有効化はサービス側の権限付与を意味しません。不足入力・権限拒否・結果不明の場合は、診断に示された確認を行ってから進みます。

[登録・更新の手順](https://zixcel.com/ja/docs/extensions)

[診断の読み方](https://zixcel.com/ja/docs/troubleshooting)

Canonical: https://zixcel.com/ja/tools/docker