
Amazon ECR のレプリケーションで削除を宛先へ伝える deleteReplication を試してみた
はじめに
2026-11-16 に、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 に加えて付与します。今回の検証は同一アカウントなので、この権限は設定していません。
宛先の確認方法
宛先リージョンで 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 の継続スキャンの課金が気になる場合に、宛先に残る不要なイメージを減らせます。








