Eclipse と の統合AWS CodeCommit
Eclipse を使用して CodeCommit リポジトリでコードを変更できます。Toolkit for Eclipse の統合は、Git 認証情報および IAM ユーザーと連携するように設計されています。既存のリポジトリのクローン作成、リポジトリの作成、リポジトリへのコード変更のコミットとプッシュなどを行うことができます。
CodeCommit で Toolkit for Eclipse を使用するには、次が必要です。
-
Eclipse がローカルコンピュータにインストールされていること。
-
有効な認証情報 (アクセスキーとシークレットキー) を持つ IAM ユーザー。この IAM ユーザーには以下も必要です。
CodeCommit 管理ポリシーと IAMSelfManageServiceSpecificCredentials 管理ポリシーの 1 つが適用されていること。
または
IAM ユーザーに既に Git 認証情報が設定されている場合、CodeCommit 管理ポリシーのいずれか、または同等のアクセス許可のいずれかです。
詳細については、CodeCommit の AWS 管理ポリシー およびセキュリティ認証情報の理解と取得を参照してください。
-
IAM でユーザー用に設定されたアクティブな一連の Git 認証情報。詳細については、「ステップ 3: CodeCommit への HTTPS 接続用の Git 認証情報を作成する」を参照してください。
トピック
ステップ 1: IAM ユーザーのアクセスキーとシークレットキーを取得する
Eclipse がインストールしてあるコンピュータで認証情報プロファイルを設定していない場合、AWS CLI と aws configure コマンドを使用して設定できます。あるいは、この手順のステップに従って、認証情報を作成およびダウンロードすることもできます。プロンプトが表示されたら、Toolkit for Eclipse にそれらを提供します。
AWS Management Console の外部で AWS を操作するには、ユーザーはプログラムによるアクセスが必要です。プログラムによるアクセスを許可する方法は、AWS にアクセスしているユーザーのタイプによって異なります。
ユーザーにプログラムによるアクセス権を付与するには、以下のいずれかのオプションを選択します。
| どのユーザーがプログラムによるアクセスを必要としますか? | To | By |
|---|---|---|
|
ワークフォース ID (IAM Identity Center で管理されているユーザー) |
一時的な認証情報を使用して、AWS CLI、AWS SDK、または AWS API へのプログラムによるリクエストに署名します。 |
使用するインターフェイス用の手順に従ってください。
|
| IAM | 一時的な認証情報を使用して、AWS CLI、AWS SDK、または AWS API へのプログラムによるリクエストに署名します。 | 「IAM ユーザーガイド」の「AWS リソースでの一時的な認証情報の使用」の指示に従ってください。 |
| IAM | (非推奨) 長期的な認証情報を使用して、AWS CLI、AWS SDK、AWS API へのプログラムによるリクエストに署名します。 |
使用するインターフェイス用の手順に従ってください。
|
ステップ 2: AWS Toolkit for Eclipse をインストールして、CodeCommit に接続する
Toolkit for Eclipse は、Eclipse に追加できるソフトウェアパッケージです。インストールし、AWS 認証情報プロファイルを使用して設定したら、Eclipse の AWS Explorer から CodeCommit に接続できます。
AWS CodeCommit モジュールを使用して Toolkit for Eclipse をインストールし、プロジェクトリポジトリへのアクセスを設定するには
-
サポートされているバージョンがまだインストールされていない場合は、ローカルコンピュータに Toolkit for Eclipse をインストールします。Toolkit for Eclipse のバージョンを更新する必要がある場合は、Toolkit のセットアップの手順に従います。
-
Eclipse では、初回実行時の経験に従うか、Eclipse メニューシステムから [設定] (場所はバージョンとオペレーティングシステムによって異なります) を開き、[AWS ツールキット] を選択します。
-
次のいずれかを行ってください。
-
初回実行時の手順に従っている場合は、認証情報プロファイルをセットアップするようプロンプトが表示されたら、AWS セキュリティ認証情報を指定します。
-
[Preferences] (詳細設定) で設定していて、認証情報プロファイルがコンピュータに既に設定されている場合は、[Default Profile] (デフォルトのプロファイル) から選択します。
-
[Preferences] (詳細設定) で設定していて、使用するプロファイルが表示されない、またはリストが空の場合は、[Add profile] (プロファイルを追加) を選択します。[Profile Details] (プロファイル詳細) に、プロファイルの名前と IAM ユーザーの認証情報 (アクセスキーとシークレットキー) を入力するか、認証情報ファイルの場所を指定します。
-
[設定] で設定していて、設定されたプロファイルがない場合は、アカウントのサインアップや既存の AWS セキュリティ認証情報の管理のためのリンクを使用してください。
-
-
Eclipse で、[AWS Toolkit] メニューを展開し、[AWS CodeCommit] を選択します。認証情報プロファイルを選択し、Git 認証情報のユーザー名とパスワードを入力するか、.csv ファイルからインポートします。[Apply] (適用)、[OK] の順に選択します。
プロファイルでサインインした後、Team Explorer に AWS CodeCommit 接続パネルが表示され、クローン、作成またはサインアウトするためのオプションが提供されます。[クローン] を選択すると、既存の CodeCommit リポジトリのクローンがローカルコンピュータに作成されるため、コードの作業を開始できます。これは最も頻繁に使用されるオプションです。
リポジトリがない場合、またはリポジトリを作成する場合は、[Create] (作成) を選択します。
Eclipse から CodeCommit リポジトリのクローンを作成する
認証情報を設定したら、Eclipse でチェックアウトすることで、コンピュータ上のローカルリポジトリにリポジトリのクローンを作成できます。その後、コードで作業を開始できます。
-
Eclipse で、AWS Explorer を開きます。これを知る方法の詳細については、「AWS Explorer にアクセスする方法」を参照してください。[AWS CodeCommit] を展開し、作業する CodeCommit リポジトリを選択します。リポジトリのコミット履歴やその他の詳細を表示できます。これは、それがクローンを作成するリポジトリとブランチであるかどうかを判断するのに役立ちます。
注記
リポジトリが表示されない場合は、フラグアイコンを選択して AWS リージョン メニューを開き、リポジトリが作成された AWS リージョン を選択します。
-
[Check out] (チェックアウト) を選択し、指示に従ってリポジトリのクローンをローカルコンピュータに作成します。
-
プロジェクトのクローン作成が完了したら、Eclipse でコードを編集し、プロジェクトのリポジトリへの変更を CodeCommit でステージング、コミット、およびプッシュする準備が整います。
Eclipse から CodeCommit リポジトリを作成する
Toolkit for Eclipse を使用して、Eclipse から CodeCommit リポジトリを作成できます。リポジトリの作成の一環として、コンピュータ上のローカルリポジトリにリポジトリのクローンを作成して、すぐに作業を開始することができます。
-
AWS Explorer で [AWS CodeCommit] を右クリックしてから、[Create repository] (リボジトリの作成) を選択します。
注記
リポジトリはリージョン固有です。リポジトリを作成する前に、正しい AWS リージョン が選択されていることを確認してください。リポジトリ作成プロセスを開始した後に、AWS リージョン を選択することはできません。
-
[Repository Name] (リポジトリ名) で、このリポジトリの名前を入力します。リポジトリ名は、アマゾン ウェブ サービスアカウント内で一意である必要があります。文字と長さの制限があります。詳細については、「クォータ」を参照してください。[Repository Description] (リポジトリの説明) で、このリポジトリの説明 (オプション) を入力します。これは、他のユーザーがこのリポジトリの用途を理解し、リージョンの他のリポジトリと区別するのに役立ちます。[OK] を選択します。
-
AWS Explorer で、[AWS CodeCommit] を展開し、先ほど作成した CodeCommit リポジトリを選択します。このリポジトリにはコミット履歴がないことが表示されます。[Check out] (チェックアウト) を選択し、指示に従ってリポジトリのクローンをローカルコンピュータに作成します。
CodeCommit リポジトリの操作
CodeCommit に接続すると、AWS Explorer に、アカウントに関連付けられたリポジトリのリスト (AWS リージョン 別) が表示されます。リージョンを変更するには、フラグメニューを選択します。
注記
CodeCommit は、Toolkit for Eclipse でサポートされているすべての AWS リージョン で利用できない場合があります。
Toolkit for Eclipse で、[Navigation] (ナビゲーション) および [Package Explorer] ビューからこれらのリポジトリの内容を参照できます。ファイルを開くには、リストからファイルを選択します。
CodeCommit リポジトリ用 Toolkit for Eclipse での Git オペレーションは、他の Git ベースのリポジトリとまったく同じように動作します。コードへの変更、ファイルの追加、ローカルコミットの作成を行うことができます。共有する準備ができたら、[Git Staging] オプションを使用して、コミットを CodeCommit リポジトリにプッシュします。Git プロファイルで作成者とコミッター情報を設定していない場合は、コミットしてプッシュする前にこれを設定できます。IAM ユーザーの Git 認証情報は既にローカルに保存され、接続された AWS 認証情報プロファイルに関連付けられているため、CodeCommit にプッシュしても、それらを再度入力するよう求められることはありません。
Toolkit for Eclipse の操作の詳細については、AWS Toolkit for Eclipse の使用開始ガイドを参照してください。
