PowerShellを使ったAWS ECRへのDockerイメージ操作手順を徹底解説

PowerShellは、Windowsや他のプラットフォームで利用できる柔軟なスクリプト言語およびシェル環境です。このツールを使用すれば、AWS（Amazon Web Services）のリソース管理を効率化することが可能です。特に、AWS Elastic Container Registry（ECR）を利用したDockerイメージの管理は、DevOpsワークフローにおいて重要な役割を果たします。

本記事では、PowerShellを活用してAWS ECRにログインし、Dockerイメージをプッシュおよびプルする具体的な手順を解説します。必要な事前準備から実際の操作手順まで、初心者でも簡単に理解できるように説明します。AWS ECRを使ったコンテナ管理をスムーズに進めたい方に最適な内容となっています。

AWS ECRの基本概要

AWS Elastic Container Registry（ECR）は、AWSが提供する完全マネージド型のコンテナイメージレジストリサービスです。開発者がDockerコンテナイメージを保存、管理、デプロイするための安全でスケーラブルな環境を提供します。

AWS ECRの特徴

1. 完全マネージドサービス

ECRは、インフラストラクチャ管理の手間を省き、コンテナイメージの保存、取得、削除などの操作を簡素化します。

2. 高いセキュリティ

ECRは、イメージの暗号化やアクセス制御をAWS Identity and Access Management（IAM）と統合して提供します。これにより、データのセキュリティを確保できます。

3. 高いスケーラビリティ

ECRは、ビジネスの規模に応じてシームレスに拡張可能で、大規模なコンテナアプリケーションにも対応します。

AWS ECRの利点

• 統合性: 他のAWSサービス（ECS、EKSなど）とネイティブに統合されており、コンテナのデプロイが容易。
• 可用性: AWSのインフラに基づく高い可用性で、グローバルに分散された開発チームにも最適。
• コスト効率: 必要な分だけ支払う従量課金制で、コストを最小限に抑えられる。

用途と具体例

AWS ECRは、マイクロサービスアーキテクチャを採用するアプリケーションや、開発と運用の間でイメージを共有するために利用されます。たとえば、開発環境でビルドしたDockerイメージをECRに保存し、本番環境のECSでデプロイするワークフローが一般的です。

AWS ECRを使用することで、コンテナイメージの管理が簡単になり、開発スピードとデプロイ効率が向上します。

必要な準備と環境設定

PowerShellを使用してAWS ECRに接続し、Dockerイメージを管理するためには、いくつかの事前準備が必要です。このセクションでは、作業を始める前に行うべき準備と設定について詳しく説明します。

1. AWSアカウントの作成

AWSサービスを利用するには、有効なAWSアカウントが必要です。以下の手順で作成してください：

1. AWS公式サイトにアクセスします。
2. 「無料で始める」をクリックし、必要な情報を入力してアカウントを作成します。
3. 支払い情報を登録し、アカウントを有効化します。

2. IAMユーザーとアクセスキーの準備

PowerShellからAWSリソースにアクセスするには、IAM（Identity and Access Management）を使用して適切な権限を設定します。

1. AWS Management ConsoleでIAMサービスに移動します。
2. 「ユーザー」を選択し、新しいユーザーを作成します。
3. 必要なアクセス権限（AmazonEC2ContainerRegistryFullAccessポリシーなど）を付与します。
4. アクセスキーIDとシークレットアクセスキーを取得します。

3. PowerShellの準備

PowerShellのインストールと更新

最新バージョンのPowerShellをインストールまたは更新します。

• Windows: Microsoft公式サイトからダウンロード可能です。
• macOS/Linux: brew install --cask powershell（macOSの場合）などのコマンドを利用します。

モジュールのインストール

AWS PowerShellモジュールをインストールします。以下のコマンドを実行してください：

Install-Module -Name AWSPowerShell -Scope CurrentUser

4. Dockerのセットアップ

PowerShellでDockerコマンドを使用するには、Docker Desktopをインストールする必要があります。

1. Docker公式サイトからDocker Desktopをダウンロードします。
2. インストール後、Docker Desktopを起動し、必要な設定を行います。

5. AWS CLIの設定

PowerShellからAWSに接続するためにAWS CLIを設定します。以下の手順を実行します：

1. AWS CLIをダウンロードしてインストールします。
2. コマンドプロンプトまたはPowerShellで次のコマンドを実行し、認証情報を設定します：

aws configure

入力を求められたら、先ほど作成したIAMユーザーのアクセスキーIDとシークレットアクセスキーを入力します。

これらの手順を完了すれば、PowerShellを使ったAWS ECR操作の準備が整います。次のセクションでは、AWS CLIの詳細な設定手順について説明します。

AWS CLIのインストールと設定

PowerShellでAWSリソースを操作するためには、AWS CLI（コマンドラインインターフェイス）のインストールと設定が必要です。このセクションでは、AWS CLIの導入と初期設定手順を詳しく解説します。

1. AWS CLIのインストール

Windowsの場合

1. AWS CLIの公式サイトからインストーラーをダウンロードします。
2. ダウンロードしたインストーラーを実行し、画面の指示に従ってインストールを完了させます。
3. PowerShellを開き、以下のコマンドを実行してインストールを確認します：

   aws --version

バージョン情報が表示されればインストール成功です。

macOS/Linuxの場合

1. ターミナルを開き、以下のコマンドを実行してAWS CLIをインストールします：

   curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
   sudo installer -pkg AWSCLIV2.pkg -target /

2. 以下のコマンドでインストールを確認します：

   aws --version

2. AWS CLIの設定

AWS CLIを使用するためには、認証情報とリージョン設定が必要です。以下の手順で設定を行います：

設定コマンド

PowerShellまたはターミナルで次のコマンドを実行します：

aws configure

入力項目

コマンド実行後、以下の情報を順番に入力します：

1. AWS Access Key ID: IAMで作成したアクセスキーIDを入力します。
2. AWS Secret Access Key: シークレットアクセスキーを入力します。
3. Default region name: 利用するAWSリージョン（例: us-east-1）を指定します。
4. Default output format: 出力形式を指定します（例: json または table）。

3. 設定の確認

以下のコマンドを実行して設定が正しく反映されているか確認します：

aws sts get-caller-identity

設定が正しい場合、アカウントIDやIAMユーザー名などが返されます。

4. 必要なECR操作のポリシー確認

IAMユーザーがECRにアクセスできるよう、以下のポリシーが設定されていることを確認してください：

• AmazonEC2ContainerRegistryFullAccess
• またはカスタムポリシーで必要な権限（ecr:GetAuthorizationToken、ecr:BatchCheckLayerAvailabilityなど）を追加。

これでAWS CLIのインストールと基本設定が完了しました。次のセクションでは、DockerのインストールとECRとの連携方法を解説します。

Dockerのインストールと設定

AWS ECRを活用するにはDockerが必要です。Dockerはコンテナのビルド、管理、デプロイを簡単に行える強力なツールです。このセクションでは、Dockerのインストール方法とAWS ECRと連携するための設定手順を解説します。

1. Dockerのインストール

Windowsの場合

1. Docker公式サイトにアクセスし、「Docker Desktop」をダウンロードします。
2. インストーラーを実行し、画面の指示に従ってインストールを進めます。
3. インストール完了後、Docker Desktopを起動します。必要に応じてWindowsコンテナモードとLinuxコンテナモードを切り替えます。

macOSの場合

1. Docker公式サイトから「Docker Desktop for Mac」をダウンロードします。
2. ダウンロードした.dmgファイルを開き、指示に従ってインストールを完了させます。
3. アプリケーションフォルダからDocker Desktopを起動します。

Linuxの場合

1. ターミナルを開き、次のコマンドを順番に実行します：

   sudo apt-get update
   sudo apt-get install docker.io

2. Dockerサービスを有効化して起動します：

   sudo systemctl enable docker
   sudo systemctl start docker

3. インストール確認：

   docker --version

2. Dockerの設定

2.1 ユーザーグループへの追加（Linuxのみ）

Linuxの場合、Dockerコマンドの実行にsudoが必要な場合があります。以下の手順でユーザーをdockerグループに追加します：

sudo usermod -aG docker $USER
newgrp docker

2.2 Dockerデーモンの確認

Dockerが正常に動作しているか確認します：

docker info

問題がない場合、Dockerデーモンのステータスが表示されます。

3. AWS ECRとDockerの連携設定

3.1 Dockerログイン設定

AWS CLIを使用してAWS ECRにログインします。以下のコマンドを実行します：

aws ecr get-login-password --region <your-region> | docker login --username AWS --password-stdin <your-account-id>.dkr.ecr.<your-region>.amazonaws.com

• <your-region>: 利用するAWSリージョン（例: us-east-1）
• <your-account-id>: AWSアカウントID

ログインが成功すると「Login Succeeded」と表示されます。

3.2 Dockerイメージの確認

既存のDockerイメージを確認するには以下を実行します：

docker images

3.3 Dockerイメージのタグ付け

ECRにプッシュするためには、イメージにECR対応のタグを付ける必要があります。以下の形式でタグ付けします：

docker tag <local-image-name>:<tag> <your-account-id>.dkr.ecr.<your-region>.amazonaws.com/<repository-name>:<tag>

4. 確認ステップ

ECRとの連携が成功しているか確認するため、ログイン後にDockerイメージをプッシュまたはプルしてみましょう。この詳細は次のセクションで解説します。

Dockerのインストールと設定を完了すれば、AWS ECRでのDockerイメージ管理をスムーズに進める準備が整います。次は、PowerShellを使用してAWS ECRにログインする方法を解説します。

PowerShellスクリプトによるAWS ECRログイン

PowerShellを活用してAWS ECRにログインすることで、Dockerイメージのプッシュやプルが可能になります。このセクションでは、AWS CLIを使用したPowerShellスクリプトの記述例とその実行手順を詳しく解説します。

1. AWS ECRログインの概要

AWS CLIを用いて、ECRにログインするにはget-login-passwordコマンドを使用します。このコマンドは、ECRにアクセスするための認証トークンを生成します。生成されたトークンをDockerに渡して認証を行います。

2. ログインスクリプトの基本構成

以下は、PowerShellでAWS ECRにログインするための基本スクリプト例です：

# AWSリージョンとアカウントIDを設定
$region = "us-east-1"
$accountId = "123456789012"
$repositoryUri = "$accountId.dkr.ecr.$region.amazonaws.com"

# AWS CLIでECRログイン用のパスワードを取得し、Dockerに渡す
aws ecr get-login-password --region $region | docker login --username AWS --password-stdin $repositoryUri

# ログイン結果を確認
if ($LASTEXITCODE -eq 0) {
    Write-Host "ECR login succeeded."
} else {
    Write-Host "ECR login failed." -ForegroundColor Red
}

3. スクリプトの実行方法

1. PowerShellを起動
   必ず管理者権限でPowerShellを実行してください。
2. スクリプトを保存
   上記のスクリプトをファイル（例: ecr-login.ps1）として保存します。
3. スクリプトを実行
   保存したスクリプトを実行するには以下のコマンドを使用します：

   .\ecr-login.ps1

4. 動作確認

スクリプトが成功した場合、以下のように表示されます：

ECR login succeeded.

失敗した場合はエラーメッセージが表示されるので、AWS CLIやDockerの設定を再確認してください。

5. エラーのトラブルシューティング

エラー例1: 「get-login-password」コマンドが見つからない

• AWS CLIが正しくインストールされていない可能性があります。
• 解決方法: aws --versionでCLIのバージョンを確認し、必要に応じて再インストールしてください。

エラー例2: Dockerログインが失敗する

• 入力したリージョンまたはアカウントIDが正しくない可能性があります。
• 解決方法: $regionと$accountIdの値をAWS Management Consoleで確認してください。

6. カスタマイズ例

複数のリージョンを操作する場合や自動化スクリプトに組み込む場合、次のようにカスタマイズできます：

$regions = @("us-east-1", "us-west-2")
foreach ($region in $regions) {
    $repositoryUri = "$accountId.dkr.ecr.$region.amazonaws.com"
    aws ecr get-login-password --region $region | docker login --username AWS --password-stdin $repositoryUri
    if ($LASTEXITCODE -eq 0) {
        Write-Host "Login succeeded for region $region."
    } else {
        Write-Host "Login failed for region $region." -ForegroundColor Red
    }
}

PowerShellを使ったAWS ECRへのログインは、簡単かつ効率的に行えるため、Dockerイメージの管理をよりスムーズにするための基盤となります。次のセクションでは、Dockerイメージのプッシュとプルの手順について解説します。

Dockerイメージのプッシュとプル

PowerShellを使用してAWS ECRにDockerイメージをアップロード（プッシュ）およびダウンロード（プル）する手順を解説します。これにより、コンテナイメージの効率的な管理が可能になります。

1. Dockerイメージのプッシュ

AWS ECRにDockerイメージをアップロードするためのステップを説明します。

1.1 リポジトリの作成

まず、AWS ECRでリポジトリを作成します。以下のコマンドをPowerShellで実行してください：

aws ecr create-repository --repository-name <repository-name> --region <region>

• <repository-name>: 作成するリポジトリの名前。
• <region>: 使用するAWSリージョン（例: us-east-1）。

リポジトリが作成されると、リポジトリURIが返されます。このURIは後のステップで使用します。

1.2 Dockerイメージのビルド

Dockerfileを使用してイメージをビルドします。PowerShellで以下のコマンドを実行します：

docker build -t <local-image-name>:<tag> .

• <local-image-name>: ローカルのイメージ名。
• <tag>: イメージのタグ（例: latest）。

1.3 イメージのタグ付け

ECRにプッシュするには、イメージにECR対応のタグを付ける必要があります：

docker tag <local-image-name>:<tag> <repository-uri>:<tag>

• <repository-uri>: 作成したリポジトリのURI。
• <tag>: 使用するタグ。

1.4 イメージのプッシュ

タグ付けしたイメージをAWS ECRにプッシュします：

docker push <repository-uri>:<tag>

プッシュが成功すると、イメージがAWS ECRに保存されます。

2. Dockerイメージのプル

AWS ECRに保存されたイメージをローカル環境にダウンロード（プル）する手順を説明します。

2.1 イメージのプル

以下のコマンドでイメージをプルします：

docker pull <repository-uri>:<tag>

• <repository-uri>: プルするイメージのリポジトリURI。
• <tag>: プルするイメージのタグ（例: latest）。

2.2 イメージの確認

ローカルにプルしたイメージが存在するか確認します：

docker images

該当のイメージが表示されればプル成功です。

3. トラブルシューティング

3.1 プッシュ中にエラーが発生する場合

• エラーメッセージ: denied: User is not authorized to perform this action
• 解決方法: IAMユーザーにECRへのアクセス権限（例: AmazonEC2ContainerRegistryFullAccess）を付与します。

3.2 プル中にエラーが発生する場合

• エラーメッセージ: repository does not exist
• 解決方法: リポジトリURIが正しいことを確認し、AWS ECRにリポジトリが存在するか確認します。

4. 自動化スクリプトの例

以下は、PowerShellを使ってイメージのプッシュとプルを自動化するスクリプトの例です：

# 設定
$region = "us-east-1"
$accountId = "123456789012"
$repositoryName = "my-repository"
$repositoryUri = "$accountId.dkr.ecr.$region.amazonaws.com/$repositoryName"

# ログイン
aws ecr get-login-password --region $region | docker login --username AWS --password-stdin $repositoryUri

# プッシュ
docker build -t my-image:latest .
docker tag my-image:latest $repositoryUri:latest
docker push $repositoryUri:latest

# プル
docker pull $repositoryUri:latest

このスクリプトを実行すれば、ECRへのログインからイメージのプッシュ・プルまで自動的に行うことができます。

AWS ECRにおけるDockerイメージの管理は、PowerShellを活用することで簡単に効率化できます。次のセクションでは記事の内容をまとめます。

まとめ

本記事では、PowerShellを使用してAWS ECRにログインし、Dockerイメージをプッシュおよびプルする手順を詳しく解説しました。AWS CLIやDockerを活用した具体的な操作方法に加え、エラー時のトラブルシューティングや自動化スクリプトの例も紹介しました。

AWS ECRは、コンテナイメージの安全な保存と効率的なデプロイを支援する強力なツールです。PowerShellとの組み合わせにより、コンテナ管理の作業を大幅に効率化できます。今回の解説をもとに、実際のプロジェクトで活用してみてください。効率的なワークフローの構築に役立つことでしょう。