MENU

PowerShellでAWS ECRのイメージを一括削除！リポジトリ整理によるコスト最適化テクニック

PowerShell

PowerShellを活用することで、AWS Elastic Container Registry（ECR）内の不要なコンテナイメージを効率的に削除し、リポジトリを整理することが可能です。多くの開発チームが、運用中に蓄積された未使用のイメージや不要なリソースにより、ECRのストレージコストが増加する課題に直面しています。本記事では、PowerShellを使った自動化スクリプトを活用し、リポジトリを整理する方法を詳しく解説します。また、コスト削減だけでなく、運用の効率化とリポジトリ管理の最適化にも焦点を当てています。AWS環境を効率よく運用したい方にとって、実践的なノウハウを提供します。

目次

AWS ECRとは


AWS Elastic Container Registry（ECR）は、Amazon Web Servicesが提供する完全マネージド型のコンテナイメージレジストリです。DockerやKubernetesなどのコンテナ化されたアプリケーションを運用するために、コンテナイメージの安全な保存、管理、およびデプロイを容易にするために設計されています。

AWS ECRの主な特徴

  • 完全マネージド: サーバーの管理やスケーリングをAWSが担当するため、ユーザーはインフラ運用の手間を省けます。
  • セキュリティ: AWS Identity and Access Management（IAM）を利用したきめ細かいアクセス制御や、イメージスキャンによるセキュリティチェック機能を提供します。
  • 統合性: AWS FargateやAmazon ECS、Amazon EKSなどのAWSサービスとシームレスに統合できます。

AWS ECRの利用目的


AWS ECRは、以下のようなシナリオで活用されます。

  1. コンテナアプリケーションの管理
    チームでの開発プロセスで使用するベースイメージを統一的に管理します。
  2. 高可用性なイメージ配信
    グローバルに展開されたAWSインフラを活用し、迅速にコンテナイメージを配信します。
  3. コスト最適化
    不要なイメージを削除することで、ストレージコストを削減しつつ、リポジトリの管理を容易にします。

AWS ECRは、効率的かつ安全にコンテナイメージを管理するための強力なツールです。本記事では、このECRをPowerShellで効率よく管理する方法に焦点を当てています。

コスト最適化の重要性

AWS ECRを利用する際に注意すべきポイントの一つが、ストレージコストです。運用を続ける中で不要なコンテナイメージが蓄積されると、ストレージ容量が無駄に増加し、コストが予想以上に膨らむ可能性があります。コスト最適化を意識したECRの管理は、効率的な運用と予算管理のために非常に重要です。

不要なコンテナイメージの影響

  1. ストレージコストの増加
    AWS ECRのストレージ料金は、保存したデータの量に比例して課金されます。使用しないイメージを放置しておくと、無駄なコストが発生します。
  2. 運用管理の複雑化
    古いイメージが大量にあると、リポジトリが煩雑になり、必要なイメージを探し出すのが困難になります。
  3. デプロイミスのリスク増加
    不要なイメージが混在することで、誤って古いイメージをデプロイするリスクが高まります。

コスト最適化のメリット

  1. 無駄な支出を削減
    不要なデータを削除することで、ストレージコストを大幅に削減できます。
  2. 運用効率の向上
    整理されたリポジトリは、必要なイメージを素早く特定でき、開発や運用のスピードを向上させます。
  3. 長期的な安定性
    定期的な整理により、リポジトリが常に最適な状態で保たれ、運用の継続性が向上します。

PowerShellによる効率化


PowerShellを活用することで、不要なイメージを効率よく一括削除でき、コスト最適化を容易に実現できます。本記事では、具体的なスクリプトの作成方法や運用のベストプラクティスを通じて、この課題へのアプローチを解説します。

PowerShellの準備

AWS ECRをPowerShellで操作するには、適切なツールのセットアップが必要です。このセクションでは、必要な環境構築手順を詳しく解説します。

1. AWS CLIのインストール


AWS ECRにアクセスするためには、AWS CLI（Command Line Interface）が必要です。以下の手順でインストールを行います：

  1. 公式サイトからインストーラをダウンロード
    AWS CLI ダウンロードページにアクセスし、システムに対応するバージョンを取得します。
  2. インストール
    インストーラを実行し、指示に従ってインストールします。LinuxやmacOSの場合はパッケージマネージャを使用してインストール可能です。
  3. インストール確認
    コマンドラインで以下を実行してバージョンを確認します。
   aws --version

2. AWS Tools for PowerShellのインストール


PowerShellでAWSサービスを操作するために、AWS Tools for PowerShellをインストールします：

  1. モジュールのインストール
    PowerShellを管理者権限で開き、以下のコマンドを実行します。
   Install-Module -Name AWSPowerShell -Scope CurrentUser
  1. インストール確認
    次のコマンドでインストールが成功しているか確認します。
   Get-Module -ListAvailable -Name AWSPowerShell

3. AWS CLIの認証設定


AWS CLIとPowerShellの両方で利用する認証情報を設定します：

  1. AWSアカウントのアクセスキーを取得
    AWSコンソールにログインし、IAMサービスからアクセスキーを作成します。
  2. 認証情報の設定
    次のコマンドを使用してアクセスキーとシークレットキーを登録します：
   aws configure


指定する情報：

  • AWS Access Key ID
  • AWS Secret Access Key
  • Default region name（例: us-east-1）
  • Default output format（例: json）

4. PowerShellの動作確認


PowerShellを起動し、以下のコマンドで動作確認を行います：

Get-ECRRepository


正しく設定されていれば、AWS ECRのリポジトリ一覧が表示されます。

5. スクリプト作成準備


PowerShellでスクリプトを作成する際の基本ルール：

  • ファイル拡張子は.ps1
  • スクリプト実行ポリシーを設定（必要に応じて）
   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

これで、PowerShellを使用したAWS ECRの操作環境が整いました。次のセクションでは、具体的なスクリプトの作成方法について解説します。

イメージの一括削除スクリプトの作成

不要なコンテナイメージを効率的に削除するために、PowerShellを使用して一括削除スクリプトを作成します。このスクリプトを活用することで、AWS ECRの整理を自動化し、運用効率を向上させることができます。

1. スクリプトの目的と概要


このスクリプトは以下の目的を達成します：

  • 不要なイメージタグを自動判別して削除
  • 特定の条件（例: 作成日時やタグのパターン）に基づく削除
  • リポジトリ内のイメージを一括整理

2. スクリプト例


以下のPowerShellスクリプトは、特定の条件に基づいて不要なイメージを削除する例です。

# AWS CLI認証設定を確認
$region = "us-east-1"  # 使用するAWSリージョンを指定
$repositoryName = "example-repository"  # 対象のリポジトリ名を指定

# 取得する日付条件を設定（例: 30日以上前のイメージを削除）
$retentionDays = 30
$thresholdDate = (Get-Date).AddDays(-$retentionDays)

# リポジトリ内のイメージタグを取得
Write-Host "Fetching image tags from repository: $repositoryName"
$imageDetails = aws ecr list-images --repository-name $repositoryName --region $region --query 'imageIds[*]' --output json | ConvertFrom-Json

# イメージの詳細を確認して削除対象を判別
foreach ($image in $imageDetails) {
    $imageDigest = $image.imageDigest
    $imageTag = $image.imageTag

    # タグ付きイメージの詳細を取得
    if ($imageTag) {
        $imageMetadata = aws ecr describe-images --repository-name $repositoryName --image-ids imageTag=$imageTag --region $region --query 'imageDetails[0]' --output json | ConvertFrom-Json
        $imagePushedAt = Get-Date $imageMetadata.imagePushedAt

        # 削除条件をチェック
        if ($imagePushedAt -lt $thresholdDate) {
            Write-Host "Deleting image: Tag=$imageTag, PushedAt=$imagePushedAt"
            aws ecr batch-delete-image --repository-name $repositoryName --image-ids imageTag=$imageTag --region $region
        }
    }
}
Write-Host "Image cleanup completed for repository: $repositoryName"

3. スクリプトの機能解説

  • リポジトリのイメージ取得
    コマンド aws ecr list-images を使用して、指定したリポジトリ内のイメージ一覧を取得します。
  • 条件の設定
    $thresholdDate を基準に、作成日が30日以上前のイメージを削除対象として判別します。
  • イメージ削除の自動化
    条件を満たしたイメージを aws ecr batch-delete-image を使用して削除します。

4. 実行手順

  1. スクリプトを .ps1 ファイルとして保存（例: ECRImageCleanup.ps1）。
  2. PowerShellで以下のコマンドを実行してスクリプトを実行：
   .\ECRImageCleanup.ps1

5. 注意点

  • 削除条件の確認: 誤って必要なイメージを削除しないように、条件設定を慎重に行ってください。
  • バックアップの検討: 必要に応じて、削除前にイメージを別の場所にバックアップしてください。

このスクリプトを使用することで、不要なコンテナイメージを効率的に削除でき、AWS ECRのストレージコストを削減し、管理の簡素化が可能です。

リポジトリ整理のベストプラクティス

AWS ECRでリポジトリを効率的に整理することは、コスト削減や運用の効率化に直結します。ここでは、効果的なリポジトリ管理を実現するためのベストプラクティスを紹介します。

1. リポジトリの命名規則を統一する


リポジトリ名の命名規則を統一することで、運用管理が容易になります。以下のポイントを考慮してください：

  • 階層構造を意識: プロジェクト名や環境（例: dev, staging, prod）をリポジトリ名に含める。
    例: project-name/dev/api-service
  • バージョン管理を反映: リリースごとにタグを使用してバージョンを明確化する。
    例: v1.0.0, v2.1.3

2. ライフサイクルポリシーを活用する


AWS ECRのライフサイクルポリシーを利用することで、指定条件に基づき古いイメージを自動削除できます。

  • ポリシーの設定例:
    以下のJSONポリシーを使用すると、最新の10個のタグ以外を削除できます：
  {
      "rules": [
          {
              "rulePriority": 1,
              "description": "Retain only last 10 tagged images",
              "selection": {
                  "tagStatus": "tagged",
                  "countType": "imageCountMoreThan",
                  "countNumber": 10
              },
              "action": {
                  "type": "expire"
              }
          }
      ]
  }


このポリシーをECRに適用すると、ポリシーに従って古いイメージが自動的に削除されます。

3. イメージスキャンを有効化する


セキュリティの観点から、ECRのイメージスキャン機能を有効化することを推奨します。これにより、イメージ内の脆弱性を検出しやすくなります。

  • 有効化コマンド:
  aws ecr put-image-scanning-configuration --repository-name example-repository --image-scanning-configuration scanOnPush=true

4. 使用頻度の低いイメージをアーカイブ化


必要だが頻繁に使用しないイメージは、コスト削減のためにアーカイブ用のS3バケットへ移動することを検討してください。

  • イメージの保存方法:
    イメージをS3に保存するためには、docker save コマンドを使用します。
  docker save -o image.tar <image_name>
  aws s3 cp image.tar s3://archive-bucket/

5. 定期的な整理スケジュールを設ける


リポジトリの整理作業を定期的に行うことをチーム全体でルール化します。たとえば：

  • 毎月1回、不要なイメージを削除する。
  • 大規模リリース後に整理を行う。

6. 自動化ツールの活用


PowerShellやAWS Lambdaを活用して、リポジトリ整理を自動化すると作業負荷を軽減できます。たとえば、定期実行スクリプトやイベント駆動型削除スクリプトを設定します。

まとめ


リポジトリ整理は単なるストレージ削減だけでなく、運用の効率化やセキュリティ強化に直結します。命名規則の統一、ライフサイクルポリシー、イメージスキャン、自動化スクリプトを組み合わせることで、AWS ECRの管理を最適化できます。

運用中のトラブルシューティング

AWS ECRをPowerShellで管理している際に発生しがちなトラブルと、その解決方法について解説します。これらの問題を理解し、迅速に対処することで、運用の効率と安定性を確保できます。

1. AWS CLI認証エラー


問題: スクリプト実行時に「Unable to locate credentials」や「AccessDeniedException」といったエラーが発生する。

原因:

  • 正しいアクセスキーとシークレットキーが設定されていない。
  • IAMロールに適切な権限が付与されていない。

解決方法:

  1. 認証情報を確認する:
   aws configure


必要に応じて正しいキー情報を再設定してください。

  1. IAMポリシーの確認: ECRにアクセスするためには、以下のようなポリシーが必要です：
   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "ecr:ListImages",
                   "ecr:DescribeImages",
                   "ecr:BatchDeleteImage",
                   "ecr:GetAuthorizationToken"
               ],
               "Resource": "*"
           }
       ]
   }

2. PowerShellスクリプトの実行エラー


問題: PowerShellスクリプトの実行中に「Access to the script is denied」や「The term is not recognized」といったエラーが表示される。

原因:

  • スクリプト実行ポリシーが制限されている。
  • コマンドのスペルミスやモジュールが正しくインストールされていない。

解決方法:

  1. 実行ポリシーを変更する：
   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
  1. モジュールを再インストールする：
   Install-Module -Name AWSPowerShell -Scope CurrentUser

3. イメージ削除が適用されない


問題: スクリプトを実行しても、不要なイメージが削除されない。

原因:

  • 削除対象の条件設定が適切でない。
  • ライフサイクルポリシーが誤って上書きされている。

解決方法:

  1. スクリプトの条件を見直す：
    $thresholdDate の設定や、削除対象イメージの選定ロジックを確認してください。
  2. ライフサイクルポリシーを再適用する：
    設定が正しいかAWSコンソールで確認し、必要に応じて再設定します。

4. イメージスキャン結果が表示されない


問題: スキャンを有効化したにもかかわらず、結果が取得できない。

原因:

  • スキャン設定が正しく有効化されていない。
  • スキャン結果の取得方法が正しくない。

解決方法:

  1. スキャンの有効化を確認する：
   aws ecr describe-repositories --repository-name example-repository --query 'repositories[0].imageScanningConfiguration.scanOnPush'


結果が true でなければ設定を有効化します。

  1. スキャン結果を確認する：
   aws ecr describe-image-scan-findings --repository-name example-repository --image-id imageTag=latest

5. リソース制限エラー


問題: 「Rate exceeded」や「ThrottlingException」が発生し、スクリプトが停止する。

原因:

  • 短時間で大量のリクエストを送信している。

解決方法:

  1. リクエスト間隔を調整する：スクリプトに遅延を追加する。
   Start-Sleep -Seconds 2
  1. AWSサポートに問い合わせてリソース制限の引き上げを検討する。

まとめ


これらのトラブルシューティングを参考に、AWS ECRをPowerShellで運用する際の問題を迅速に解決しましょう。定期的なスクリプトの検証と設定の見直しにより、より安定した運用が可能になります。

まとめ

本記事では、PowerShellを使用してAWS ECRを効率的に整理し、不要なイメージを一括削除する方法を解説しました。AWS ECRに蓄積された不要なリソースを削除することで、コスト削減と運用効率の向上を実現できます。また、リポジトリ整理のベストプラクティスやトラブルシューティングを通じて、実際の運用中に発生する課題にも対応できる知識を習得できたはずです。

PowerShellスクリプトやライフサイクルポリシーを活用し、定期的にECRを整理することで、長期的なAWS運用の安定性と効率性を確保しましょう。今後のクラウド管理がよりスムーズに進むことを願っています。

PowerShell
PowerShell AWS クラウド管理 コスト最適化 ECR

この記事を書いた人

佐藤健司のアバター 佐藤健司

実務の現場で詰まりがちなポイントを地図にするITブログ「IT trip」を運営。Windows／Office（Teams・Excel）からSQL、サーバ運用、ガジェットまで、再現性のある手順と“なぜそうなるか”を丁寧に解説します。読んだらすぐ試せること、そして迷った人の次の一歩が見えることを大切にしています。

関連記事

コメント

コメントする

目次