AWS CodeCommit
ユーザーガイド (API バージョン 2015-04-13)

このガイドの手順では、新しいコンソールデザインがサポートされています。古いバージョンのコンソールを選択すると、古い概念が反映され、本ガイドの基本的な手順がそのまま適用されます。新しいコンソールのヘルプにアクセスするには、情報アイコンを選択します。

AWS CodeCommit のセットアップ

AWS マネジメントコンソール にサインインし、AWS CodeCommit コンソールからリポジトリに直接ファイルをアップロード、追加または編集します。これは、素早く変更を加える方法です。ただし、複数のファイルの操作、ブランチ間のファイルなどを行う場合には、ローカルコンピューターを動作してリポジトリで作業することを考慮してください。AWS CodeCommit の最も簡単な設定方法は、AWS CodeCommit 用に HTTPS Git 認証情報を設定することです。この HTTPS 認証方法は以下のとおりです。

  • 静的なユーザー名とパスワードを使用します。

  • AWS CodeCommit でサポートされているすべてのオペレーティングシステムで機能します。

  • Git 認証情報をサポートする統合開発環境 (IDE) やその他の開発ツールとも互換性があります。

運用上の理由から Git 認証情報を使用したくない、または使用できない場合は、他の方法を使用できます。以下に示している他の選択肢をよく読み、お客様に最適な代替方法を決定してください。

Git 認証情報を使用した設定

HTTPS 接続と Git 認証情報を使用すると、IAM で静的ユーザー名とパスワードが生成されます。これらの認証情報は、Git だけでなく、Git のユーザー名およびパスワード認証をサポートするサードパーティーツールでも使用します。この方法は、ほとんどの IDE と開発ツールでサポートされています。また、AWS CodeCommit で使用する最もシンプルで簡単な接続方法です。

  • Git 認証情報を使用する HTTPS ユーザー用: Git 認証情報を使用して、ローカルコンピュータと AWS CodeCommit リポジトリとの間の接続を設定するには、これらの指示に従ってください。

  • 開発ツールからの接続: Git 認証情報を使用して、IDE または他の開発ツールと AWS CodeCommit リポジトリとの間の接続を設定するには、これらのガイドラインに従ってください。Git 認証情報をサポートする IDE には、Visual Studio、Eclipse、Xcode、IntelliJ などがあります (これらに限定されません)。

他の方法を使用した設定

HTTPS ではなく SSH プロトコルを使用して、AWS CodeCommit リポジトリに接続できます。SSH 接続では、SSH 認証用に Git および AWS CodeCommit が使用するパブリックキーとプライベートキーのファイルをローカルマシンで作成します。パブリックキーを IAM ユーザーに関連付けます。プライベートキーをローカルマシンに保存します。SSH では、パブリックキーとプライベートキーのファイルを手動で作成し管理する必要があるため、AWS CodeCommit で使用するには、Git 認証情報がよりシンプルで使いやすい場合があります。

Git 認証情報とは異なり、SSH 接続設定は、ローカルコンピュータのオペレーティングシステムによって異なります。

  • AWS CLI を使用していないユーザーの SSH: すでにパブリック/プライベートキーペアがあり、ローカルコンピュータの SSH 接続に精通している場合は、これらの指示 (要約) に従ってください。

  • Linux, macOS, or Unix 上で SSH 接続する場合: パブリック/プライベートキーペアを作成し、Linux, macOS, or Unix オペレーティングシステムで接続を設定する手順については、これらの指示に従ってください。

  • Windows での SSH 接続の場合: パブリック/プライベートキーペアを作成し、Windows オペレーティングシステムで接続を設定する手順については、これらの指示に従ってください。

フェデレーションアクセスまたは一時認証情報を使用して AWS CodeCommit および AWS に接続している場合、または IAM ユーザーを設定しない場合は、AWS CLI に含まれる認証情報ヘルパーを使用して AWS CodeCommit リポジトリへの接続を設定できます。Git では、AWS で認証して AWS CodeCommit リポジトリとやり取りする必要があるときはいつでも、認証情報ヘルパーにより、HTTPS 接続で、暗号署名付きの IAM ユーザー認証情報または Amazon EC2 インスタンスロールを使用できます。これは、IAM ユーザーを必要としない AWS CodeCommit リポジトリの唯一の接続方法であるため、フェデレーションアクセスおよび一時認証情報をサポートする唯一の方法でもあります。 一部のオペレーティングシステムと Git バージョンには、独自の認証情報ヘルパーがあり、AWS CLI に含まれる認証情報ヘルパーと競合します。そのため、AWS CodeCommit の接続に問題が発生する可能性があります。使いやすくするには、認証情報ヘルパーを使用する代わりに、IAM ユーザーを作成し HTTPS 接続と Git 認証情報を設定することを検討してください。

他の AWS アカウントにホストされている AWS CodeCommit リポジトリに接続する場合には、AWS CLI に含まれるロール、ポリシーおよび認証情報ヘルパーを使用してアクセスを設定し、接続をセットアップできます。

AWS CodeCommit、Git、およびその他のコンポーネントの互換性

AWS CodeCommit で作業するときは、Git を使用します。他のプログラムを使用することもできます。以下の表では、バージョン互換性に関する最新のガイダンスを示します。

AWS CodeCommit のバージョン互換性に関する情報

コンポーネント バージョン
Git AWS CodeCommit は Git バージョン 1.7.9 以降をサポートしています。
Curl AWS CodeCommit では、curl 7.33 以降が必要です。 ただし、HTTPS と curl update 7.41.0 には既知の問題があります。詳細については、「トラブルシューティング」を参照してください。