Git および の開始方法AWS CodeCommit

CodeCommit リポジトリを作成するには

1. https://console.aws.amazon.com/codesuite/codecommit/home で CodeCommit コンソールを開きます。

2. リージョンセレクタを使用して、リポジトリを作成する AWS リージョン を選択します。詳細については、「リージョンと Git 接続エンドポイント」を参照してください。

3. [Repositories (リポジトリ)] ページで、[Create repository (リポジトリの作成)] を選択します。

4. [リポジトリの作成] ページの [リポジトリ名] に、新しいリポジトリの名前を入力します (例: MyDemoRepo)。

   注記

   リポジトリ名は 100 文字以内 (大文字と小文字は区別する) で入力してください。詳細については、「制限」を参照してください。

5. (オプション) [Description (説明)] に、説明 (例: My demonstration repository) を入力します。この説明は、お客様と他のユーザーがリポジトリの用途を識別するのに役立ちます。

6. (オプション) [Add tag] を選択して 1 つ以上のリポジトリタグ (AWS リソースを整理して管理するのに役立つカスタム属性ラベル) をリポジトリに追加します。詳細については、「でのリポジトリのタグ付け AWS CodeCommit」を参照してください。

7. (オプション) [追加設定] を展開して、このリポジトリ内のデータの暗号化と復号にデフォルトの AWS マネージドキーを使用するか、独自のカスタマーマネージドキーを使用するかを指定します。独自のカスタマーマネージドキーを使用する場合は、リポジトリを作成している AWS リージョンでそのキーが使用可能であることと、キーがアクティブであることを確認する必要があります。詳細については、「AWS Key Management Service と AWS CodeCommit リポジトリの暗号化」を参照してください。

8. (オプション) このリポジトリに Java または Python コードが含まれ、CodeGuru Reviewer でコードを分析する場合は、[Enable Amazon CodeGuru Reviewer for Java and Python] (Java および Python 用に Amazon CodeGuru Reviewer を有効化) を選択します。CodeGuru Reviewer は複数の機械学習モデルを使用して、コードの欠陥を検出し、プルリクエストの改善と修正を自動的に提案します。詳細については、Amazon CodeGuru Reviewer ユーザーガイドを参照してください。

9. [Create] を選択します。

1. https://console.aws.amazon.com/codesuite/codecommit/home で CodeCommit コンソールを開きます。

2. リージョンセレクタで、リポジトリが作成されたAWS リージョン を選択します。リポジトリは、AWS リージョン に固有のものです。詳細については、「リージョンと Git 接続エンドポイント」を参照してください。

3. 接続するリポジトリをリストから見つけて選択します。[クローン URL] を選択してから、リポジトリのクローン作成やリポジトリへの接続時に使用するプロトコルを選択します。これにより、クローン URL が複製されます。

   • IAM ユーザー、または AWS CLI に含まれている認証情報ヘルパーで Git 認証情報を使用している場合は、HTTPS URL をコピーします。

   • ローカルコンピュータで git-remote-codecommit コマンドを使用している場合は、HTTPS (GRC) URL をコピーします。

   • IAM ユーザーで SSH パブリック/プライベートキーペアを使用している場合は、SSH URL をコピーします。

   注記

   リポジトリのリストではなく [ようこそ] ページが表示される場合、ログインしている AWS リージョン の AWS アカウントに関連付けられているリポジトリはありません。リポジトリを作成するには、「AWS CodeCommit リポジトリを作成する」を参照するか、「Git と CodeCommit の開始方法」チュートリアルのステップに従います。

4. (オプション) リポジトリのデフォルトのブランチの名前として main を使用するようにローカル Git クライアントを設定することをお勧めします。これは、このガイドのすべての例で、デフォルトのブランチに使用される名前です。また、コンソールで最初のコミットを行う場合に CodeCommit が使用するデフォルトのブランチ名とも同じです。次のコマンドを実行して、デフォルトのブランチ名をシステムにおいてグローバルに設定します。

   git config --global init.defaultBranch main

   すべてのリポジトリで異なるデフォルトのブランチ名を使用する場合は、main を任意の名前に置き換えてください。このチュートリアルでは、デフォルトのブランチの名前が main であることを前提としています。

   リポジトリごとに異なるデフォルトのブランチ名を使用する場合は、この属性をグローバル (--local) ではなくローカル (--global) に設定できます。

5. ターミナルまたはコマンドプロンプトで、git clone コマンドを使用してリポジトリのクローンを作成し、ステップ 3 でコピーしたクローン URL を指定します。クローン URL は、使用するプロトコルと設定によって異なります。例えば、HTTPS と Git 認証情報を使用して、米国東部 (オハイオ) リージョンで MyDemoRepo という名前のリポジトリのクローンを作成する場合:

   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   HTTPS を git-remote-codecommit で使用している場合:

   git clone codecommit://MyDemoRepo my-demo-repo

   SSH を使用している場合:

   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   注記

   リポジトリのクローン作成時にエラーが表示される場合は、ローカルコンピュータに必要なセットアップが完了していない可能性があります。詳細については、「のセットアップ AWS CodeCommit」を参照してください。

1. テキストエディタを使用して、ディレクトリに以下の 2 つのサンプルテキストファイルを作成します。ファイルに cat.txt および dog.txt という名前を付けます。

   cat.txt
   -------
   The domestic cat (Felis catus or Felis silvestris catus) is a small, usually furry, domesticated, and carnivorous mammal.

   dog.txt
   -------
   The domestic dog (Canis lupus familiaris) is a canid that is known as man's best friend.

2. git config を実行して、プレースホルダー your-user-name と your-email-address で表されている、ユーザー名と E メールアドレスをローカルレポジトリに追加します。これにより、コミットを識別しやすくなります。

   git config --local user.name "your-user-name"
   git config --local user.email your-email-address

3. ローカルリポジトリの作成時にデフォルトのブランチ名をグローバルに設定しなかった場合は、次のコマンドを実行して、デフォルトのブランチ名を main に設定します。

   git config --local init.defaultBranch main

4. git add を実行して、変更をステージングします。

   git add cat.txt dog.txt

5. git commit を実行して、以下の変更をコミットします。

   git commit -m "Added cat.txt and dog.txt"

   ヒント

   先ほど行ったコミットの詳細を表示するには、git log を実行します。

1. /tmp ディレクトリか c:\temp ディレクトリに切り替えます。

2. git clone を実行して、リポジトリのコピーを共有リポジトリにプルダウンします。

   HTTPS の場合:

   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo

   git-remote-codecommit で HTTPS を使用する場合:

   git clone codecommit://MyDemoRepo shared-demo-repo

   SSH の場合:

   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo

   注記

   Windows オペレーティングシステムで SSH を使用してリポジトリのクローンを作成する場合は、以下のように SSH キー ID の接続文字列への追加が必要になる場合があります。

   git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   詳細については、「Windows で SSH 接続をセットアップする手順」を参照してください。

   このコマンドでは、MyDemoRepo は CodeCommit リポジトリの名前です。shared-demo-repo は /tmp ディレクトリか c:\temp ディレクトリで Git が作成するディレクトリの名前です。ディレクトリの作成後、Git はリポジトリのコピーを shared-demo-repo ディレクトリにプルダウンします。

3. shared-demo-repo ディレクトリに切り替えます。

   (For Linux, macOS, or Unix) cd /tmp/shared-demo-repo
   (For Windows) cd c:\temp\shared-demo-repo

4. git config を実行して、プレースホルダー other-user-name と other-email-address で表されている、別のユーザー名と E メールアドレスを追加します。これにより、他のユーザーが作成するコミットをより簡単に識別できます。

   git config --local user.name "other-user-name"
   git config --local user.email other-email-address

5. テキストエディタを使用して、shared-demo-repo ディレクトリに以下のサンプルテキストファイルを作成します。ファイルに horse.txt という名前を付けます。

   horse.txt
   -------
   The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.

6. git add を実行して、変更を共有リポジトリにステージングします。

   git add horse.txt

7. git commit を実行して、変更を共有リポジトリにコミットします。

   git commit -m "Added horse.txt"

8. ローカルリポジトリ (git push) のデフォルトブランチから、Git が CodeCommit リポジトリ (origin) に使用するデフォルトのリモート名で初期コミットをプッシュするために main を実行します。

   git push -u origin main

9. ローカルリポジトリに切り替えて、git pull を実行し、共有リポジトリが CodeCommit リポジトリに対して作成したコミットをローカルリポジトリにプルします。その後、git log を実行して、共有リポジトリから開始されたコミットを確認します。

1. ローカルリポジトリから、ブランチの名前 (git checkout など) と、ローカルリポジトリで作成した最初のコミットの ID を指定して、MyNewBranch を実行します。

   コミットの ID がわからない場合は、git log を実行して取得します。コミットのユーザー名と E メールアドレスが、他のユーザーのものではなく、お客様のものであることを確認してください。これにより、main が、CodeCommit リポジトリの安定したバージョンであり、MyNewBranch が、比較的不安定な新しい機能に使用されるブランチであることがシミュレートされます。

   git checkout -b MyNewBranch commit-ID

2. git push を実行して、ローカルリポジトリから CodeCommit リポジトリに新しいブランチを送信します。

   git push origin MyNewBranch

3. 続いて、そのブランチを共有リポジトリにプルし、結果を確認します。

   1. 共有リポジトリディレクトリ (shared-demo-repo) に切り替えます。

   2. 新しいブランチをプルします (git fetch origin)。

   3. ブランチがプルされたことを確認します (git branch --all はリポジトリ内のすべてのブランチのリストを表示します)。

   4. 新しいブランチに切り替えます (git checkout MyNewBranch)。

   5. MyNewBranch ブランチに切り替えたことを確認するには、git status または git branch を実行します。出力に現在のブランチが表示されます。この場合は MyNewBranch です。

   6. ブランチ内のコミットのリストを表示します (git log)。

   呼び出す Git コマンドのリストは以下のとおりです。

   git fetch origin
   git branch --all
   git checkout MyNewBranch
   git branch or git status
   git log

4. main ブランチに戻り、そのコミットのリストを表示します。Git のコマンドは以下のようになります。

   git checkout main
   git log

5. ローカルリポジトリ内の main ブランチに切り替えます。git status または git branch を実行できます。出力に現在のブランチが表示されます。この場合は main です。Git のコマンドは以下のようになります。

   git checkout main
   git branch or git status

1. ローカルリポジトリから、新しいタグの名前 (git tag) と、ローカルリポジトリで作成した最初のコミットの ID を指定して、release を実行します。

   コミットの ID がわからない場合は、git log を実行して取得します。コミットのユーザー名と E メールアドレスが、他のユーザーのものではなく、お客様のものであることを確認してください。これにより、コミットが CodeCommit リポジトリの安定したバージョンであることがシミュレートされます。

   git tag release commit-ID

   git tag をもう一度実行して、他のユーザーからのコミットに beta タグを付けます。これにより、それが比較的不安定な新しい機能に使用されるコミットであることがシミュレートされます。

   git tag beta commit-ID

2. git push --tags を実行して、CodeCommit リポジトリにタグを送信します。

3. ここで、タグを共有リポジトリにプルし、結果を確認します。

   1. 共有リポジトリディレクトリ (shared-demo-repo) に切り替えます。

   2. 新しいタグをプルします (git fetch origin)。

   3. タグがプルされたことを確認します (git tag はリポジトリ内のタグのリストを表示します)。

   4. 各ログ (git log release および git log beta) に関する情報を表示します。

   呼び出す Git コマンドのリストは以下のとおりです。

   git fetch origin
   git tag
   git log release
   git log beta

4. これをローカルリポジトリでも試してみます。

   git log release
   git log beta

1. AWS Management Console にサインインして、IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。

   で使用したものと同じユーザー名とパスワードでサインインします設定

2. ナビゲーションペインで [ユーザー] を選択し、続いて [Create New Users (新しいユーザーの作成)] を選択します。

3. 最初の [Enter User Names] (ユーザー名を入力) ボックスに、サンプルユーザー名 (JaneDoe-CodeCommit など) を入力します。[Generate an access key for each user (ユーザーごとにアクセスキーを生成)] ボックスを選択し、[作成] を選択します。

4. [Show User Security Credentials] を選択します。アクセスキー ID とシークレットアクセスキーをメモするか、[Download Credentials (認証情報のダウンロード)] を選択します。

5. Git 認証情報を使用した HTTPS ユーザーのセットアップ の手順に従って、IAM ユーザーの認証情報を生成して入力します。

   SSH を使用する場合は、「SSH および Linux、macOS、または Unix: Git と CodeCommit 用にパブリックキーとプライベートキーをセットアップする」または「ステップ 3: Git および CodeCommit 用のパブリックキーとプライベートキーをセットアップする」の指示に従って、パブリックキーとプライベートキーでユーザーを設定します。

6. git pull を実行します。以下のエラーが表示されます。

   HTTPS の場合:

   fatal: unable to access 'https://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   SSH の場合:

   fatal: unable to access 'ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   このエラーが表示されるのは、新しいユーザーに共有リポジトリを CodeCommit リポジトリに同期させるアクセス許可がないためです。

7. IAM コンソールに戻ります。ナビゲーションペインで、[Policies] を選択し、[Create Policy] を選択します。([Get Started] ボタンが表示された場合は、そのボタンを選択してから、[Create Policy] を選択します)。

8. [独自のポリシーを作成] の横で、[選択] を選択します。

9. [Policy Name] (ポリシー名) ボックスに、名前 (例: CodeCommitAccess-GettingStarted) を入力します。

10. [Policy Document] (ポリシードキュメント) ボックスに以下のように入力して、IAM ユーザーがその IAM ユーザー自身に関連付けられたリポジトリからプルできるようにします。

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull"
          ],
          "Resource": "*"
        }
      ]
    }

    ヒント

    IAM ユーザーがその IAM ユーザー自身に関連付けられたリポジトリにコミットをプッシュできるようにするには、代わりに以下のように入力します。

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull",
            "codecommit:GitPush"
          ],
          "Resource": "*"
        }
      ]
    }

    他の CodeCommit アクションや、リソースに対してユーザーに付与できるその他のアクセス許可については、AWS CodeCommitの認証とアクセスコントロール を参照してください。

11. ナビゲーションペインで [Users] (ユーザー) を選択します。

12. ポリシーをアタッチするサンプルユーザー名 (JaneDoe-CodeCommit など) を選択します。

13. [Permissions] タブを選択します。

14. [管理ポリシー] で、[Attach Policy (ポリシーのアタッチ)] を選択します。

15. 先ほど作成した CodeCommitAccess-GettingStarted ポリシーを選択してから、[Attach Policy] (ポリシーのアタッチ) を選択します。

16. git pull を実行します。今回は、コマンドが機能し、"Already up-to-date" メッセージが表示されます。

17. HTTPS を使用する場合は、元の Git 認証情報、または git-remote-codecommit を使用している場合は通常のプロファイルに切り替えます。詳細については、「Git 認証情報を使用した HTTPS ユーザーのセットアップ」または「git-remote-codecommit を使用して AWS CodeCommit への HTTPS 接続をセットアップする手順」の指示を参照してください。

    SSH を使用している場合は、元のキーに切り替えます。詳細については、「SSH および Linux、macOS、または Unix: Git と CodeCommit 用にパブリックキーとプライベートキーをセットアップする」または「ステップ 3: Git および CodeCommit 用のパブリックキーとプライベートキーをセットアップする」を参照してください。

1. https://console.aws.amazon.com/codesuite/codecommit/home で CodeCommit コンソールを開きます。

2. [Dashboard] (ダッシュボード) ページのリポジトリのリストから、[MyDemoRepo] を選択します。

3. ナビゲーションペインで [Settings] (設定) をクリックします。

4. [設定] ページの [リポジトリの削除] で、[リポジトリの削除] を選択します。

5. [Type the name of the repository to confirm deletion] (削除の確認のため、リポジトリ名を入力) の横にあるボックスに MyDemoRepo と入力し、[Delete] (削除) を選択します。