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

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

CodeCommit のセットアップ

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

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

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

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

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

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

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

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

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

他の方法を使用した設定

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

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

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

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

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

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

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

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

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

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

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