Amazon ECR のレプリケーションで削除を宛先へ伝える deleteReplication を試してみた

Amazon ECR のレプリケーションで削除を宛先へ伝える deleteReplication を試してみた

Amazon ECR のレプリケーションで deleteReplication を有効化すると、有効化後にソースで行ったイメージやタグの削除が宛先にも反映されます。us-east-1 から us-east-2 へのレプリケーションで試すと、タグ指定とダイジェスト指定の削除は数秒で反映され、宛先の CloudTrail に記録されました。
2026.11.19

はじめに

2026-11-16 に、Amazon ECR のレプリケーションでイメージの削除とタグの削除を宛先へ伝えられるようになりました。

https://aws.amazon.com/jp/about-aws/whats-new/2026/11/replication-deletes-amazon-ecr/

レプリケーションルールで deleteReplication を有効にすると、有効化後にソースで行ったイメージの削除とタグの削除が、宛先にも反映されます。us-east-1 から us-east-2 へのレプリケーションで、ソースのタグやイメージを削除し、宛先への反映と CloudTrail の記録を確認しました。

検証準備

検証環境

ソースは us-east-1、宛先は us-east-2 で、同一アカウント内です。ルールには devio-repl-del を接頭辞とするフィルターを付けました。検証用イメージのサイズは560バイト、AWS CLI のバージョンは 2.41.0 です。

レプリケーション設定

次の JSON を replication-delete-enabled.json として保存し、ソースリージョン(us-east-1)に適用します。registryId には宛先のアカウント ID を入れます。

{
  "rules": [
    {
      "destinations": [
        { "region": "us-east-2", "registryId": "111122223333" }
      ],
      "repositoryFilters": [
        { "filter": "devio-repl-del", "filterType": "PREFIX_MATCH" }
      ],
      "deleteReplication": { "enabled": true }
    }
  ]
}
aws ecr put-replication-configuration --region us-east-1 --replication-configuration file://replication-delete-enabled.json

クロスアカウントで使う場合は、宛先レジストリのアクセス許可ポリシーに ecr:ReplicateImageDelete が必要です。ecr:ReplicateImage と ecr:CreateRepository に加えて付与します。今回の検証は同一アカウントなので、この権限は設定していません。

https://docs.aws.amazon.com/AmazonECR/latest/userguide/replication-delete.html

宛先の確認方法

宛先リージョンで describe-images を呼び、タグとダイジェストの組を見ます。

aws ecr describe-images --region us-east-2 --repository-name devio-repl-del/main --query 'sort_by(imageDetails,&imagePushedAt)[].{tags:imageTags,digest:imageDigest}'

反映までの時間は、このコマンドを2秒間隔で繰り返すスクリプト(poll-dest.sh)で測りました。

poll-dest.sh
#!/usr/bin/env bash
# 使い方: poll-dest.sh <リポジトリ名> <終了条件> [間隔秒] [上限秒]
# 宛先リージョンの describe-images を一定間隔で呼び、結果が変わるたびに時刻つきで出力する。
# 終了条件: gone      = リポジトリ内のイメージが0件になる
#           tags=a,b  = タグ集合が a,b と一致する(カンマ区切り。順不同)
#           present   = イメージが1件以上ある
set -uo pipefail
REPO="$1"; COND="$2"; INT="${3:-5}"; MAX="${4:-1800}"
DST="${DST_REGION:-us-east-2}"
START=$(date +%s); LAST=""
while :; do
  NOW=$(date +%s); EL=$((NOW-START))
  OUT=$(aws ecr describe-images --region "$DST" --repository-name "$REPO" \
        --query 'sort_by(imageDetails,&imagePushedAt)[].{tags:imageTags,digest:imageDigest}' --output json 2>&1)
  if echo "$OUT" | grep -q RepositoryNotFoundException; then OUT='"RepositoryNotFound"'; fi
  COMPACT=$(echo "$OUT" | tr -d ' \n')
  if [ "$COMPACT" != "$LAST" ]; then
    echo "$(date +%Y-%m-%dT%H:%M:%S%z) +${EL}s $COMPACT"
    LAST="$COMPACT"
  fi
  case "$COND" in
    gone)    [ "$COMPACT" = "[]" ] && { echo "$(date +%Y-%m-%dT%H:%M:%S%z) +${EL}s CONDITION_MET gone"; exit 0; } ;;
    present) [ "$COMPACT" != "[]" ] && [ "$COMPACT" != '"RepositoryNotFound"' ] && { echo "$(date +%Y-%m-%dT%H:%M:%S%z) +${EL}s CONDITION_MET present"; exit 0; } ;;
    tags=*)  WANT=$(echo "${COND#tags=}" | tr ',' '\n' | sort | paste -sd,)
             HAVE=$(echo "$OUT" | python3 -c 'import sys,json
try:
    d=json.load(sys.stdin)
    print(",".join(sorted(t for i in d for t in (i.get("tags") or []))))
except Exception: print("")')
             [ "$HAVE" = "$WANT" ] && [ -n "$WANT" ] && { echo "$(date +%Y-%m-%dT%H:%M:%S%z) +${EL}s CONDITION_MET $COND"; exit 0; } ;;
  esac
  [ "$EL" -ge "$MAX" ] && { echo "$(date +%Y-%m-%dT%H:%M:%S%z) +${EL}s TIMEOUT"; exit 1; }
  sleep "$INT"
done

宛先へ伝わる削除

レプリケーションは非同期で、結果整合です(User Guide)。そのため、以下の秒数は1回ずつの測定値です。

deleteReplication を有効にしたルールで、ソースの devio-repl-del/main にイメージ A(タグ a1、a2)とイメージ B(タグ b1、b2)を push し、宛先へ複製されたことを確認しました。削除は、イメージ A のタグ a2、イメージ A のタグ a1、イメージ B のダイジェストの順に行います。

複数タグのうち1つ

イメージ A から a2 だけを削除します(実行時刻 20:31:32)。

aws ecr batch-delete-image --region us-east-1 --repository-name devio-repl-del/main --image-ids imageTag=a2
$ ./poll-dest.sh devio-repl-del/main tags=a1,b1,b2 2 300
2026-11-18T20:31:34+0900 +0s [{"tags":["a2","a1"],"digest":"sha256:a1850d6ee549dd96b9485ba1c5e02410e92a5ab3d38fa36f0af69ad3daf57820"},{"tags":["b2","b1"],"digest":"sha256:0a011b9b48d31abc26915f7964053ee83ab9d1d27875a60337963a55aa49e998"}]
2026-11-18T20:31:37+0900 +3s [{"tags":["a1"],"digest":"sha256:a1850d6ee549dd96b9485ba1c5e02410e92a5ab3d38fa36f0af69ad3daf57820"},{"tags":["b2","b1"],"digest":"sha256:0a011b9b48d31abc26915f7964053ee83ab9d1d27875a60337963a55aa49e998"}]

宛先のイメージ A から a2 だけが外れ、イメージ B のタグは変わりませんでした。宛先への反映は、削除コマンドの実行から5秒後でした(20:31:32 → 20:31:37)。

最後のタグ

イメージ A に残った a1 を削除します(実行時刻 20:31:46)。

aws ecr batch-delete-image --region us-east-1 --repository-name devio-repl-del/main --image-ids imageTag=a1
$ ./poll-dest.sh devio-repl-del/main tags=b1,b2 2 300
2026-11-18T20:31:48+0900 +0s [{"tags":["a1"],"digest":"sha256:a1850d6ee549dd96b9485ba1c5e02410e92a5ab3d38fa36f0af69ad3daf57820"},{"tags":["b2","b1"],"digest":"sha256:0a011b9b48d31abc26915f7964053ee83ab9d1d27875a60337963a55aa49e998"}]
2026-11-18T20:31:51+0900 +3s [{"tags":["b2","b1"],"digest":"sha256:0a011b9b48d31abc26915f7964053ee83ab9d1d27875a60337963a55aa49e998"}]

宛先ではタグ a1 だけでなく、イメージ A そのものが消えました。反映は5秒後でした(20:31:46 → 20:31:51)。

ダイジェスト指定

イメージ B をダイジェストで削除します(実行時刻 20:31:51)。

aws ecr batch-delete-image --region us-east-1 --repository-name devio-repl-del/main --image-ids imageDigest=sha256:0a011b9b48d31abc26915f7964053ee83ab9d1d27875a60337963a55aa49e998
$ ./poll-dest.sh devio-repl-del/main gone 2 300
2026-11-18T20:31:53+0900 +0s [{"tags":["b2","b1"],"digest":"sha256:0a011b9b48d31abc26915f7964053ee83ab9d1d27875a60337963a55aa49e998"}]
2026-11-18T20:31:56+0900 +3s []

宛先ではイメージ B と2つのタグ(b1、b2)が一度に消え、リポジトリ内のイメージが0件になりました。反映は5秒後でした(20:31:51 → 20:31:56)。

削除の記録

宛先リージョンの CloudTrail で、イベント名 ReplicateImageDelete を検索しました。

aws cloudtrail lookup-events --region us-east-2 --lookup-attributes AttributeKey=EventName,AttributeValue=ReplicateImageDelete --start-time 2026-11-18T20:25:00+09:00 --query 'Events[].{time:EventTime,name:EventName,user:Username}'
[
    {
        "time": "2026-11-18T20:31:36+09:00",
        "name": "ReplicateImageDelete",
        "user": "ECRReplication"
    }
]

検索結果は4件で、ソースでの削除3回より1件多く、最後のタグの削除(20:31:46)に対して 20:31:48 の記録が2件ありました。上の出力は、4件のうちタグ a2 の削除(20:31:32)に対応する1件です。その詳細を抜粋します。アカウント ID は置き換えています。

"arn": "arn:aws:sts::111122223333:assumed-role/AWSServiceRoleForECRReplication/ECRReplication",
"invokedBy": "replication.ecr.amazonaws.com",
"requestParameters": null,
"responseElements": null,
"resources": [
    {
        "accountId": "111122223333",
        "ARN": "arn:aws:ecr:us-east-2:111122223333:repository/devio-repl-del/main"
    }
],

4件とも、記録されている対象はリポジトリ ARN だけで、削除されたタグとダイジェストは分かりません。

まとめ

ECR のレプリケーションで、ソースでのイメージとタグの削除が宛先に反映されることを確認しました。

イメージをライフサイクルポリシーではなく手動で削除している場合、ソースと宛先の両方で削除する手間をなくせます。

特に、イメージが大きくてストレージ課金が嵩む場合や、Amazon Inspector の継続スキャンの課金が気になる場合に、宛先に残る不要なイメージを減らせます。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事