AWS Cloud9 は新規顧客には利用できなくなりました。 AWS Cloud9 の既存のお客様は、通常どおりサービスを引き続き使用できます。[詳細はこちら](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS CodeCommit の チュートリアル AWS Cloud9
AWS CodeCommit チュートリアルを使用して、CodeCommit のリモートコードリポジトリとやり取りする AWS Cloud9 開発環境を設定できます。CodeCommit は、 AWS クラウドでの Git リポジトリのプライベートな保存と管理を有効にするソースコード制御サービスです。CodeCommit の詳細については、[AWS CodeCommit ユーザーガイド](https://docs.aws.amazon.com/codecommit/latest/userguide/)を参照してください。
このチュートリアルに従い、このサンプルを作成すると、 に料金が発生する可能性があります AWS アカウント。これには、Amazon EC2 や CodeCommit などのサービスで発生する可能性がある料金も含まれます。詳細については、「[Amazon EC2 コスト](https://aws.amazon.com/ec2/pricing/)」および「[AWS CodeCommit コスト](https://aws.amazon.com/codecommit/pricing/)」を参照してください。
+ [前提条件](#sample-codecommit-prereqs)
+ [ステップ 1: 必要なアクセス許可を持つ IAM グループを設定する](#sample-codecommit-permissions)
+ [ステップ 2: でリポジトリを作成する AWS CodeCommit](#sample-codecommit-create-repo)
+ [ステップ 3: 環境をリモートリポジトリに接続する](#sample-codecommit-connect-repo)
+ [ステップ 4: リモートリポジトリのクローンを環境に作成する](#sample-codecommit-clone-repo)
+ [ステップ 5: リポジトリにファイルを追加する](#sample-codecommit-add-files)
+ [ステップ 6: クリーンアップする](#sample-codecommit-clean-up)
## 前提条件
このサンプルを使用する前に、設定が次の要件を満たしていることを確認します。
+ **既存の AWS Cloud9 EC2 開発環境が必要です。**このサンプルは、Amazon Linux または Ubuntu Server を実行する Amazon EC2 インスタンスに接続された EC2 環境が既にあることを前提としています。別のタイプの環境またはオペレーティングシステムがある場合、このサンプルの指示を関連ツールを設定する必要がある場合があります。詳細については、「[での環境の作成 AWS Cloud9](create-environment.md)」を参照してください。
+ **既存の環境の AWS Cloud9 IDE が既に開いている。**環境を開くと、 はウェブブラウザでその環境の IDE AWS Cloud9 を開きます。詳細については、「[で環境を開く AWS Cloud9](open-environment.md)」を参照してください。
## ステップ 1: 必要なアクセス許可を持つ IAM グループを設定する
AWS 認証情報が の管理者ユーザーに関連付けられていて AWS アカウント、そのユーザーを使用して CodeCommit を操作する場合、[「」のステップ 2: リポジトリを作成する AWS CodeCommit](#sample-codecommit-create-repo)「」に進みます。
このステップは、[AWS マネジメントコンソール](#sample-codecommit-permissions-console) または [AWS コマンドラインインターフェイス (AWS CLI)](#sample-codecommit-permissions-cli) を使って完了できます。
### コンソールを使用して、必要なアクセス許可を持つ IAM グループを設定する
1. まだサインインしていない場合は AWS マネジメントコンソール、 にサインインします。
このステップでは、 AWS アカウントの管理者ユーザーの認証情報を使用してサインインすることをお勧めします。これが実行できない場合は、 AWS アカウント 管理者にお問い合わせください。
1. [IAM コンソール] を開きます。これを行うには、コンソールのナビゲーションバーで、［**サービス**］を選択します。次に、**[IAM]** を選択します。
1. ［**グループ**］を選択します。
1. グループの名前を選択します。
1. ［**アクセス許可**］タブの［**管理ポリシー**］で［**ポリシーのアタッチ**］を選択します。
1. ポリシー名のリストで、次のいずれかのボックスを選択します。
+ **AWSCodeCommitPowerUser** を選択すると、CodeCommit のすべての機能とリポジトリ関連リソースにアクセスできます。ただし、これによりCodeCommit リポジトリを削除したり AWS のサービス、Amazon CloudWatch Events などの他の でリポジトリ関連のリソースを作成または削除したりすることはできません。
+ **AWSCodeCommitFullAccess** を選択して、 の CodeCommit リポジトリおよび関連リソースを完全に制御します AWS アカウント。これにはリポジトリを削除する機能も含まれます。
どちらのポリシー名もリストに表示されない場合は、**[Filter]** (フィルター) ボックスにポリシー名を入力して表示させます。
1. ［**ポリシーをアタッチ**] を選択します。
これらの AWS 管理ポリシーがグループに付与するアクセス許可のリストを確認するには、「 *AWS CodeCommit ユーザーガイド*」の[AWS 「 の 管理 (事前定義) ポリシー AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#managed-policies)」を参照してください。
ステップ [2: リポジトリを作成する AWS CodeCommit](#sample-codecommit-create-repo)に進みます。
### を使用して必要なアクセス許可を持つ IAM グループを設定する AWS CLI
IAM `attach-group-policy` コマンドを実行し、グループの名前と、必要なアクセス許可を記述する AWS 管理ポリシーの Amazon リソースネーム (ARN) を指定します。構文は次のとおりです。
```
aws iam attach-group-policy --group-name MyGroup --policy-arn POLICY_ARN
```
前述のコマンドで、`MyGroup` をグループの名前に置き換えます。を AWS マネージドポリシーの ARN `POLICY_ARN`に置き換えます。
+ `arn:aws:iam::aws:policy/AWSCodeCommitPowerUser` を選択すると、CodeCommit のすべての機能とリポジトリ関連リソースにアクセスできます。ただし、CodeCommit リポジトリを削除したり AWS のサービス、Amazon CloudWatch Events などの他の でリポジトリ関連のリソースを作成または削除したりすることはできません。
+ `arn:aws:iam::aws:policy/AWSCodeCommitFullAccess` は、 の CodeCommit リポジトリおよび関連リソースを完全に制御できます AWS アカウント。これにはリポジトリを削除する機能も含まれます。
これらの AWS 管理ポリシーがグループに付与するアクセス許可のリストを確認するには、「 *AWS CodeCommit ユーザーガイド*」の[AWS 「 の 管理 (事前定義) ポリシー AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#managed-policies)」を参照してください。
## ステップ 2: CodeCommit でリポジトリを作成する
このステップでは、CodeCommit コンソールを使用して CodeCommit にリモートコードリポジトリを作成します。
すでに CodeCommit リポジトリがある場合は、「[ステップ 3: 環境をリモートリポジトリに接続する](#sample-codecommit-connect-repo)」に進みます。
このステップは、[AWS マネジメントコンソール](#sample-codecommit-create-repo-console)または [AWS コマンドラインインターフェース(AWS CLI)](#sample-codecommit-create-repo-cli)を使って完了できます。
### コンソールを使用して CodeCommit でリポジトリを作成する
1. 前のステップで管理者ユーザー AWS マネジメントコンソール として にサインインしていて、管理者ユーザーを使用してリポジトリを作成したくないとします。次に、 からサインアウトします AWS マネジメントコンソール。
1. [https://console.aws.amazon.com/codecommit](https://console.aws.amazon.com/codecommit) で CodeCommit コンソールを開きます。
1. コンソールのナビゲーションバーで、リージョンセレクタを使用して、リポジトリの作成先の AWS リージョン を選択します (例: **米国東部 (オハイオ**)。
1. ウェルカムページが表示された場合は、［**今すぐ始める**］を選択します。それ以外の場合は、［**リポジトリの作成**］を選択します。
1. **[Create repository]** (リポジトリの作成) ページの **[Repository name]** (レポジトリ名) に、新しいレポジトリの名前を入力します (例: `MyDemoCloud9Repo`)。(別の名前を選択する場合は、このサンプル全体でそれに置き換えてください。)
1. (オプション) **[Description]** (説明) に、リポジトリに関する説明を入力します。例えば、`This is a demonstration repository for the AWS Cloud9 sample.` と入力します。
1. ［**リポジトリの作成**］を選択します。［**リポジトリに接続**］ペインが表示されます。［**閉じる**］を選択します。このトピックの後半で別の方法でリポジトリに接続するためです。
「[ステップ 3: 環境をリモートリポジトリに接続する](#sample-codecommit-connect-repo)」に進みます。
### を使用して CodeCommit でリポジトリを作成する AWS CLI
AWS CodeCommit `create-repository` コマンドを実行します。リポジトリの名前、オプションの説明、リポジトリ AWS リージョン を作成する を指定します。
```
aws codecommit create-repository --repository-name MyDemoCloud9Repo --repository-description "This is a demonstration repository for the AWS Cloud9 sample." --region us-east-2
```
前述のコマンドで、`us-east-2` を AWS リージョン の ID に置き換えてリポジトリを作成します。サポートされているリージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「[AWS CodeCommit](https://docs.aws.amazon.com/general/latest/gr/rande.html#codecommit_region)」を参照してください。
(別のリポジトリ名を使用する場合は、このサンプル全体でそれに置き換えてください。)
## ステップ 3: 環境をリモートリポジトリに接続する
このステップでは、IDE AWS Cloud9 を使用して、前のステップで作成または識別した CodeCommit リポジトリに接続します。
**注記**
ビジュアルインターフェイスを使って Git を操作したい場合は、リモートリポジトリをクローンすることができます。次に、IDE の [Git パネル](source-control-gitpanel.md)機能を使用してファイルを追加できます。
使用する AWS Cloud9 開発環境の種類に応じて、次の一連の手順のいずれかを完了します。
****
| **環境タイプ** | **以下の手順に従います** |
| --- | --- |
| EC2 環境 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/sample-codecommit.html) |
| SSH 環境 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/sample-codecommit.html) |
## ステップ 4: リモートリポジトリのクローンを環境に作成する
このステップでは、IDE AWS Cloud9 を使用して CodeCommit のリモートリポジトリを環境にクローンします。
リポジトリのクローンを作成するには、**`git clone`** コマンドを実行します。`CLONE_URL` をリポジトリのクローン URL に置き換えます。
```
git clone CLONE_URL
```
EC2 環境には、`https://` で始まる HTTPS クローン URL を指定します。SS 環境 には、`ssh://` で始まる SSH クローン URL を指定します。
リポジトリの完全なクローン URL を取得するには、*AWS CodeCommit 「 ユーザーガイド*[」の AWS CodeCommit 「コンソールを使用してリポジトリの詳細を表示する](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-view-repository-details.html#how-to-view-repository-details-console)」を参照してください。
リポジトリにファイルがない場合は、「`You appear to have cloned an empty repository.`」のような警告メッセージが表示されます。これは想定される動作です。これについては後で説明します。
## ステップ 5: リポジトリにファイルを追加する
このステップでは、 AWS Cloud9 環境にクローンしたリポジトリに 3 つのシンプルなファイルを作成します。次に、クローンしたリポジトリの Git ステージング領域にファイルを追加します。最後に、ステージングされたファイルをコミットして、そのコミットを CodeCommit のリモートリポジトリにプッシュします。
クローンされたリポジトリにすでにファイルが含まれている場合、操作は不要で、このサンプルの残りの部分はスキップできます。
**リポジトリにファイルを追加するには**
1. 新しいファイルを作成します。メニューバーで［**File (ファイル)**］、［**New File (新規ファイル)**］の順に選択します。
1. ファイルに次のコンテンツを入力し、**File**, **Save** を選択して、 AWS Cloud9 環境の `MyDemoCloud9Repo` ディレクトリ`bird.txt`に としてファイルを保存します。
```
bird.txt
--------
Birds are a group of endothermic vertebrates, characterized by feathers,
toothless beaked jaws, the laying of hard-shelled eggs, a high metabolic
rate, a four-chambered heart, and a lightweight but strong skeleton.
```
**注記**
このファイルが正しいディレクトリに保存されたことを確認するには、**[Save As]** (名前を付けて保存)ダイアログボックスで `MyDemoCloud9Repo` フォルダを選択します。次に、**[Folder] ** (フォルダ) に `/MyDemoCloud9Repo` が表示されていることを確認します。
1. 次の内容で、`insect.txt` および `reptile.txt` という名前のファイルを 2 つ作成します。ファイルを `MyDemoCloud9Repo` ディレクトリに保存します。
```
insect.txt
----------
Insects are a class of invertebrates within the arthropod phylum that
have a chitinous exoskeleton, a three-part body (head, thorax, and abdomen),
three pairs of jointed legs, compound eyes, and one pair of antennae.
```
```
reptile.txt
-----------
Reptiles are tetrapod (four-limbed vertebrate) animals in the class
Reptilia, comprising today's turtles, crocodilians, snakes,
amphisbaenians, lizards, tuatara, and their extinct relatives.
```
1. ターミナルで、**`cd`** コマンドを実行して `MyDemoCloud9Repo` ディレクトリに切り替えます。
```
cd MyDemoCloud9Repo
```
1. **`git status`** コマンドを実行して、ファイルが正しく `MyDemoCloud9Repo` ディレクトリに保存されたことを確認します。3 つのファイルはすべて追跡されていないファイルとして表示されます。
```
Untracked files:
(use "git add ..." to include in what will be committed)
bird.txt
insect.txt
reptile.txt
```
1. **`git add`** コマンドを実行して、ファイルを Git ステージング領域に追加します。
```
git add --all
```
1. **`git status`** コマンドを実行して、ファイルが正しく Git ステージング領域に追加されたことを確認します。3 つのファイルがすべてコミットされる変更としてリストされます。
```
Changes to be committed:
(use "git rm --cached ..." to unstage)
new file: bird.txt
new file: insect.txt
new file: reptile.txt
```
1. **`git commit`** コマンドを実行して、ステージングされたファイルをコミットします。
```
git commit -m "Added information about birds, insects, and reptiles."
```
1. **`git push`** コマンドを実行して、コミットを CodeCommit のリモートリポジトリにコマンドをプッシュします。
```
git push -u origin master
```
1. ファイルが正常にプッシュされたかどうかを確認します。CodeCommit コンソール ([https://console.aws.amazon.com/codecommit](https://console.aws.amazon.com/codecommit)) を開きます (まだ開いていない場合)。
1. 右上のナビゲーションバーで、リポジトリを作成した AWS リージョン を選択します (例: **米国東部 (オハイオ)**)。
1. ［**ダッシュボード**］ページで、［**MyDemoCloud9Repo**］を選択します。3 つのファイルが表示されます。
CodeCommit リポジトリの試用を続行するには、*AWS CodeCommit ユーザーガイド* の「[リポジトリの内容を参照する](https://docs.aws.amazon.com/codecommit/latest/userguide/getting-started-cc.html#getting-started-cc-browse)」を参照してください。
Git を初めて使用する場合で CodeCommit リポジトリに手を加えたくない場合は、[[Git を試す]](https://try.github.io/) ウェブサイトのサンプル Git リポジトリを試してください。
## ステップ 6: クリーンアップする
このサンプルの使用が完了した AWS アカウント 後に に継続的に課金されないようにするには、CodeCommit リポジトリを削除します。手順については、*AWS CodeCommit 「 ユーザーガイド*[」の AWS CodeCommit 「リポジトリの削除](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html)」を参照してください。
必ず環境も削除してください。手順については、「[環境の削除](delete-environment.md)」を参照してください。