AWS Cloud9 は新規顧客には利用できなくなりました。 AWS Cloud9 の既存のお客様は、通常どおりサービスを引き続き使用できます。[詳細はこちら](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 他の AWS サービスの使用
を使用する場合は AWS Cloud9、Amazon Lightsail、 AWS CodeStar、および と緊密に連携できます AWS CodePipeline。このセクションのトピックは、これを行う方法についてです。
**重要**
Toolkit AWS 機能は、、 AWS Lambda、 AWS Serverless Application Model Amazon S3 などの主要な AWS サービスを操作するための便利なビジュアルインターフェイスを提供します。詳細については、「[Toolkit の使用 AWS](toolkit-welcome.md)」を参照してください。
**Topics**
+ [Amazon Lightsail インスタンスの使用](lightsail-instances.md)
+ [の使用 AWS CodePipeline](codepipeline-repos.md)
+ [CodeCatalyst の使用](ide-toolkits-cloud9.md)
+ [の使用 AWS CDK](cdk-explorer.md)
# IDE AWS Cloud9 でのAmazon Lightsailインスタンスの操作
AWS Cloud9 IDE を使用して、一般的なアプリケーションやフレームワークで事前設定されたAmazon Lightsailインスタンスでコードを使用できます。これらには WordPress、LAMP (Linux、Apache、MySQL、およびPHP)、Node.js、NGINX、Drupal、および Joomla が含まれます。Amazon Linux、Ubuntu、Debian、FreeBSD、および openSUSE などの Linux ディストリビューションが含まれています。
Lightsail は、便利で迅速なセットアップが可能な仮想プライベートサーバーソリューションを提供します。 Lightsailは、コンピューティング、ストレージ、ネットワーク容量と、ウェブサイトやウェブアプリケーションをクラウドにデプロイおよび管理するための機能を提供します。Lightsail は、低価格で予測可能な月額料金のため、プロジェクトをすばやく開始することができます。詳細については、「[Amazon Lightsail の特徴](https://amazonlightsail.com/features/)」を参照してください。
このトピックでは、 と互換性のある Linux ベースのLightsailインスタンスを作成してセットアップします AWS Cloud9。次に、SSH AWS Cloud9 開発環境を作成してLightsailインスタンスに接続します。
**注記**
これらの手順を完了すると、 に料金が発生する可能性があります AWS アカウント。Lightsail などのサービスに対して発生する可能性がある料金も含まれます。詳細については、[Amazon Lightsail の料金](https://aws.amazon.com/lightsail/pricing/)を参照してください。
AWS Cloud9 IDE を使用して、サンプルコードを含まない Amazon Linux または Ubuntu Server を実行している Amazon EC2 インスタンスを操作するには、「」を参照してください[開始方法: ベーシックチュートリアル](tutorials-basic.md)。
+ [ステップ 1: Linux ベースの Lightsail インスタンスを作成する](#lightsail-instances-create)
+ [ステップ 2: で使用するインスタンスを設定する AWS Cloud9](#lightsail-instances-setup)
+ [ステップ 3: AWS Cloud9 SSH 開発環境を作成し接続する](#lightsail-instances-environment)
+ [ステップ 4: AWS Cloud9 IDE を使用してインスタンスのコードを変更する](#lightsail-instances-change-code)
## ステップ 1: Linux ベースの Lightsail インスタンスを作成する
このステップでは、Lightsail コンソールを使用して、Linux ベースのディストリビューションでアプリケーションを実行する Amazon EC2 インスタンスを作成します。このインスタンスには自動的に以下のものが含まれます。
+ パブリック IP アドレスとプライベート IP アドレス (静的パブリック IP は後で作成できます)。
+ ポート 22 を介した SSH、ポート 80 を介した HTTP、ポート 443 を介した HTTPS を使用して、インスタンスにアクセスします (これらの設定は変更できます。)
+ ブロックストレージディスク (後で追加のディスクをアタッチできます)。
+ 組み込みのシステムレポート
Lightsail コンソールでは、インスタンスを後でバックアップ、再起動、停止、または削除することができます。
1. を開き、[https://lightsail.aws.amazon.com](https://lightsail.aws.amazon.com) でLightsailコンソールにサインインします。
AWS アカウントの IAMIAM 管理者ユーザーの認証情報を使用してサインインすることをお勧めします。IAM 管理者ユーザーとしてサインインできない場合は、 AWS アカウント の管理者にチェックしてください。
1. プロンプトが表示されたら、コンソールで使用する言語を選択して、［**保存**］を選択します。
1. プロンプトが表示されたら、［**では、始めましょう**］を選択します。
1. ［**インスタンス**］タブが既に選択されているホームページで、［**インスタンスの作成**］を選択します。
![\[Lightsail コンソールで [インスタンスの作成] ボタンを選択する\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/images/console-lightsail-create-instance.png)
1. **インスタンスの場所**については、インスタンスを作成する場所 AWS リージョン AWS Cloud9 が であることを確認します。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[AWS Cloud9](https://docs.aws.amazon.com/general/latest/gr/rande.html#cloud9_region)」を参照してください。 AWS リージョン、アベイラビリティーゾーン、またはその両方を変更するには、** AWS リージョンとアベイラビリティーゾーンの変更**を選択し、画面の指示に従います。
1. ［**インスタンスイメージの選択**］に対しては、［**プラットフォームの選択**］には **Linux/Unix** をすでに選択しており、［**Select a blueprint (設計図の選択)**］には［**アプリ \$1 OS**］がすでに選択されている状態で、設計図を選択します。
![\[Lightsail コンソールでインスタンスプラットフォームとブループリントを選択する\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/images/console-lightsail-pick-instance-image.png)
**注記**
アプリケーションを持たないインスタンスを作成する場合は、［**アプリ \$1 OS**］の代わりに［**OS のみ**］を選択してから、ディストリビューションを選択します。
使用可能なオプションについては、Lightsail ウェブサイトの「[Amazon Lightsail インスタンスイメージの選択](https://lightsail.aws.amazon.com/ls/docs/getting-started/article/compare-options-choose-lightsail-instance-image)」を参照してください。
1. ［**インスタンスプランの選択**］で、プランを選択するか、選択済みのデフォルトプランのままにします。
1. **[Name your instance]** (インスタンスの名前の指定) に、インスタンスの名前を入力するか、推奨のデフォルト名のままにします。
1. インスタンス数には、作成するインスタンスの数を入力するか、デフォルトの 1 インスタンス ([**x 1**]) のままにします。
1. **[作成]** を選択します。
## ステップ 2: インスタンスを使用するようにインスタンスを設定する AWS Cloud9
このステップでは、実行中のインスタンスに接続し、後で AWS Cloud9 が使用できるようにセットアップします。
**注記**
以下の手順では、前のステップで［**アプリ \$1 OS**］を選択したものとします。代わりに［**OS のみ**］と、［**Ubuntu**］以外のディストリビューションを選択した場合は、以下の手順を適切に読み替える必要があります。
1. 前のステップで開いたままの Lightsail コンソールの [**インスタンス**] タブで、インスタンスのカードにあるインスタンス名を選択します。
![\[Lightsail コンソールでインスタンスの詳細の表示を選択する\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/images/console-lightsail-show-instance-details.png)
1. **[Connect]** (接続) タブ上の **[Connect using your own SSH client]** (独自の SSH クライアントを使用して接続) で、**[Public IP]** (パブリック IP) と**[User name]** (ユーザー名) の値を書き留めます。後に必要になります。
![\[Lightsail コンソールに表示されるインスタンスのパブリックアドレスとユーザー名\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/images/console-lightsail-instance-ip-user.png)
1. ［**SSH を使用して接続**］を選択します。
1. インスタンスに最新のシステム更新があることを確認してください。これを行うには、表示されたターミナルセッションで、コマンド **`sudo apt update`** を実行します。
1. Python がインストール済みであるかどうかをチェックし、インストール済みである場合は、バージョンが 2.7 であることを確認します。バージョンを確認するには、コマンド **`python --version`** を実行し、表示されるバージョン番号を書き留めます。バージョン番号が表示されないか、バージョンが 2.7 でない場合は、コマンド** `sudo apt install -y python-minimal` **を実行してインスタンスに Python 2.7 をインストールします。
1. Node.js がインストールされているかどうかを確認し、存在する場合はバージョンが 0.6.16 以降であることを確認します。バージョンを確認するには、コマンド **`node --version`** を実行し、表示されるバージョン番号を書き留めます。バージョン番号が表示されない場合、またはバージョンが 0.6.16 以降でない場合は、Node Version Manager (nvm) を使用してインスタンスに Node.js をインストールすることをお勧めします。
これを行うには、以下のコマンドを一度に 1 つずつ以下の順序で実行します。インスタンスを更新するには、インスタンスに Node Version Manager (nvm) をインストールし、インスタンスで nvm をアクティブにしてから、最新バージョンの Node.js をインスタンスにインストールします。
```
sudo apt update
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash
. ~/.bashrc
nvm install node
```
1. コマンド **`which node`** を実行し、表示される値を書き留めます。後で必要になります。
**注記**
コマンドの出力**`which node`**が のような場合`/usr/sbin/node`、そのパスに Node.js AWS Cloud9 が見つかりません。代わりに、この手順の前のステップで説明したように、`nvm` を使用して Node.js をインストールします。コマンド `which node` をもう一度実行し、表示される新しい値を書き留めます。
1. インスタンスで[AWS Cloud9 インストーラをダウンロードして実行](installer.md#installer-download-run)します。
## ステップ 3: SSH AWS Cloud9 開発環境を作成して接続する
このステップでは、 AWS Cloud9 コンソールとインスタンスのターミナルを使用して SSH 環境を作成し、その環境を実行中のインスタンスに接続します。
1. 前のステップでターミナルセッションを開いたままにして、次のように AWS Cloud9 コンソールにサインインします。
+ を使用するのはお客様だけであるか、単一の IAM ユーザー AWS アカウント である場合は AWS アカウント、[https://console.aws.amazon.com/cloud9/](https://console.aws.amazon.com/cloud9/) にアクセスしてください。
+ 組織が を使用している場合は AWS IAM アイデンティティセンター、サインイン手順について AWS アカウント 管理者にお問い合わせください。
**注記**
このステップでは、2 つの異なる AWS のサービス を同時に使用します。IAM 管理者ユーザーとして Lightsail コンソールにサインインしたものの、別のエンティティに新しい SSH 環境を所有させたいとします。この場合は、別のウェブブラウザを開き、そのエンティティとして AWS Cloud9 コンソールにサインインすることを提案します。
1. AWS Cloud9 コンソールで、フレームワークでインスタンスを作成した AWS リージョン と一致する を選択します。
![\[AWS AWS Cloud9 コンソールのリージョンセレクター\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/images/consolas_region_new_UX.png)
1. ようこそページが表示された場合は、**新しい AWS Cloud9 環境** で環境**の作成** を選択します。それ以外の場合は、［**Create environment (環境の作成)**］を選択します。
![\[ウェルカムページが表示されら、［Next step (次のステップ)］ボタンを選択する\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/images/create_welcome_env_new_UX.png)
または:
![\[ウェルカムページが表示されない場合は、［Create environment (環境の作成)］ボタンを選択する\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/images/console_create_env_new_UX.png)
1. ［**名前環境**］ページで、［**Name (名前)**］に環境の名前を入力します。
1. **[説明]** フィールドに、環境の説明を追加します。
1. **[環境タイプ]** で、**[既存のコンピューティング]** を選択します。**[ユーザー]** オプションと **[ホスト]** オプションを表示するには、このオプションを選択する必要があるため、これは重要です。
1. **[User]** (ユーザー) に**[User name]** (ユーザー名) の値を入力します。
1. **[Host]** (ホスト) に**[Public IP]** (パブリック IP) の値を入力します。
1. ［**Port (ポート)**］は、デフォルト値の［**22**］のままにしておきます。
1. **[その他の詳細]** を展開します。
1. **環境パス**には、ログイン後に から AWS Cloud9 始まるパスを入力します`~/`。これはユーザーのホームディレクトリのルートです。
1. [**Node.js binary path]** (Node.js バイナリパス) に、前に書き留めたコマンド **`which node`** の値を入力します。
1. ［**SSH jump host (SSH ジャンプホスト)**］は空白のままにします。
1. この環境用に が AWS Cloud9 作成するパブリック SSH キーをシステムクリップボードに保存します。これを行うには、［**Copy key to clipboard (キーをクリップボードにコピーする)**］を選択します。
**注記**
コピーしたパブリック SSH キーの値を確認するには、［**View public SSH key (パブリック SSH キーの表示)**］を展開します。
1. インスタンスにコピーしたパブリック SSH キーの値を保存します。これを行うには、インスタンスにインストール済みである一般的なテキストエディタ vi を使用します。
1. インスタンスのターミナルセッションで、コマンド **`vi ~/.ssh/authorized_keys`** を実行します。
1. 表示される vi エディタで、ファイルの最後に移動し、挿入モードに切り替えます。これを行うには `I` を押してから `A` を押します。(vi エディタの下部に **-- INSERT --** が表示されます)。
1. `Enter` を 2 回押して、ファイルの末尾に 2 つの改行を追加します。
1. コピーしたばかりのパブリック SSH キー値を含むシステムクリップボードの内容をターミナルセッションのクリップボードに貼り付けます。これを行うには、ターミナルセッションウィンドウの一番下にあるクリップボードボタンをクリックし、システムクリップボードの内容をボックスに貼り付けます。
![\[Lightsail ターミナルセッションのクリップボードを開く\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/images/console-lightsail-terminal-clipboard.png)
1. ターミナルセッションのクリップボードの内容を vi エディタに貼り付けます。これを行うには、vi エディター内の挿入ポイントで `Ctrl + Shift + V` を押します。
1. ファイルを保存します。これを行うには、`Esc` を押してコマンドモードを入力します。(vi エディターの下部から［**-- INSERT --**］が消えます)。`:wq` と入力します (ファイルを `write` して、vi エディタを `quit` します)。次に `Enter` を押します。
1. AWS Cloud9 コンソールに戻り、**次のステップ**を選択します。
1. ［**Review choices (選択内容を確認する)**］ページで、［**Create environment (環境の作成)**］を選択します。が環境 AWS Cloud9 を作成し、環境の AWS Cloud9 IDE を表示するまで待ちます。これには数分間かかる場合があります。
が環境 AWS Cloud9 を作成すると、環境の AWS Cloud9 IDE が表示されます。
が少なくとも 5 分後に IDE を表示 AWS Cloud9 しない場合、ウェブブラウザ、 AWS アクセス許可、インスタンス、または関連する Virtual Private Cloud (VPC) に問題がある可能性があります。環境の修正については、[トラブルシューティング](troubleshooting.md#troubleshooting-env-loading)の「*環境を開くことができない*」を参照してください。
## ステップ 4: AWS Cloud9 IDE を使用してインスタンスのコードを変更する
新しい環境に IDE が表示されたので、Lightsail ターミナルセッションの代わりに IDE のターミナルセッションを使用できます。この IDE では、豊富なコード編集エクスペリエンスを提供しており、複数のプログラミング言語とランタイムデバッガがサポートされています。また、IDE には、色テーマ、ショートカットキーバインディング、プログラミング言語固有の構文の色付けとコードの書式設定なども含まれます。
IDE の使用方法を学ぶためには、「[IDE AWS Cloud9 のツアー](tour-ide.md)」を参照してください。
インスタンス上のコードを変更する方法については、以下のリソースをお勧めします。
+ **All** [Lightsail ウェブサイトの「powered by Bitnami」Lightsail イメージ](https://lightsail---aws.amazon.com.rproxy.govskope.cals/docs/how-to/article/log-in-to-your-bitnami-application-running-on-amazon-lightsail)のアプリケーションのパスワードの取得
+ **Drupal**: Bitnami ウェブサイトの [BitnamiDrupal For AWS クラウド](https://docs.bitnami.com/aws/apps/drupal/)、および Drupal ウェブサイトの[チュートリアルとサイトレシピ](https://www.drupal.org/node/627198)
+ **GitLab CE**: Bitnami ウェブサイトの [BitnamiGitLab CE for AWS クラウド](https://docs.bitnami.com/aws/apps/gitlab/)、および GitLab ウェブサイトの[GitLab ドキュメンテーション](https://docs.gitlab.com/ce/)
+ う**Joomla**: Bitnami ウェブサイトの [BitnamiJoomla\$1 For AWS クラウド](https://docs.bitnami.com/aws/apps/joomla/)、および Joomla\$1 ウェブサイトでの [Joomla\$1 の使用開始](https://www.joomla.org/about-joomla/getting-started.html)
+ **LAMP スタック**: Bitnami ウェブサイトの [BitnamiLAMP for AWS クラウド](https://docs.bitnami.com/aws/infrastructure/lamp/)
+ **Magento**: Bitnami ウェブサイト の [BitnamiMagento For AWS クラウド](https://docs.bitnami.com/aws/apps/magento/)、およびMagento ウェブサイトの [Magentoユーザーガイド](http://docs.magento.com/m1/ce/user_guide/getting-started.html)
+ **MEAN**: Bitnami ウェブサイトの [BitnamiMEAN For AWS クラウド](https://docs.bitnami.com/aws/infrastructure/mean/)
+ **NGINX**: Bitnami ウェブサイトの [BitnamiNGINX For AWS クラウド](https://docs.bitnami.com/aws/infrastructure/nginx/)、および NGINX ウェブサイトでの [NGINXWiki](https://www.nginx.com/resources/wiki/)
+ **Node.js**: Bitnami ウェブサイトの [BitnamiNode.Js For AWS クラウド](https://docs.bitnami.com/aws/infrastructure/nodejs/)、および Node.js ウェブサイトの[使用開始ガイド](https://nodejs.org/en/docs/guides/getting-started-guide/)
+ **Ubuntu の Plesk ホスティングスタック**: [Amazon Lightsail での Plesk のセットアップと設定](https://aws.amazon.com/getting-started/hands-on/plesk-on-aws/)。
+ **Redmine**: Bitnami ウェブサイトの [Bitnami Redmine For AWS クラウド](https://docs.bitnami.com/aws/apps/redmine/)、および Redmine ウェブサイトの[使用開始](http://www.redmine.org/projects/redmine/wiki/Getting_Started)
+ **WordPress**: [Lightsail ウェブサイトの Amazon Lightsail インスタンス、および Bitnami ウェブサイトの「[Bitnami WordPress For AWS クラウド](https://docs.bitnami.com/aws/apps/wordpress/)」から WordPress の使用を開始する](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-tutorial-launching-and-configuring-wordpress)
# IDE AWS CodePipeline での AWS Cloud9 の使用
AWS Cloud9 統合開発環境 (IDE) を使用して、 と互換性のあるリポジトリでソースコードを操作できます AWS CodePipeline。
CodePipeline は、ソフトウェアおよびそれに対する継続的な変更をリリースするために必要なステップのモデル化、視覚化、およびオートメーションに使用できる継続的な配信サービスです。CodePipeline を使用して、ソフトウェアリリースプロセスのさまざまなステージをすばやくモデル化して設定できます。詳細については、「[AWS CodePipeline ユーザーガイド](https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html)」を参照してください。
**注記**
これらの手順を完了すると、 AWS アカウントに料金が発生する可能性があります。これには、Amazon EC2、CodePipeline、Amazon S3 などのサービス、および CodePipeline でサポートされている AWS サービスに対して発生する可能性のある料金が含まれます。詳細については、「[Amazon EC2 料金表](https://aws.amazon.com/ec2/pricing/)」、「[AWS CodePipeline 料金表](https://aws.amazon.com/codepipeline/pricing/)」、「[Amazon S3 料金表](https://aws.amazon.com/s3/pricing/)」、および「[クラウドサービス料金表](https://aws.amazon.com/pricing/services/)」を参照してください。
+ [ステップ 1: ソースコードリポジトリを作成または識別する](#codepipeline-repos-create-source-code)
+ [ステップ 2: AWS Cloud9 開発環境を作成し、それをコードリポジトリに接続して、コードをアップロードする](#codepipeline-repos-connect-to-repo)
+ [ステップ 3: を使用する準備をする AWS CodePipeline](#codepipeline-repos-setup)
+ [ステップ 4: でパイプラインを作成する AWS CodePipeline](#codepipeline-repos-create-pipeline)
## ステップ 1: ソースコードリポジトリを作成または識別する
このステップでは、CodePipeline と互換性があるソースコードリポジトリを作成または識別します。
このトピックの後半では、ソフトウェアのソースコードをそのリポジトリにアップロードします。CodePipeline は、同様に作成した関連パイプラインを使用して、そのリポジトリにアップロードされたソースコードを構築、テスト、デプロイします。
ソースコードリポジトリは、CodePipelineがサポートする次のリポジトリタイプの一つである必要があります。
+ **AWS CodeCommit**。CodeCommit 内に使用したいリポジトリが既に存在する場合は、「[ステップ 2: AWS Cloud9 開発環境を作成し、それをコードリポジトリに接続して、コードをアップロードする](#codepipeline-repos-connect-to-repo)」に進んでください。それ以外の場合、CodeCommit を使用するには、この順で、*AWS CodeCommit のサンプル*の指示を守ってから、このトピックに戻ります。
+ [ステップ 1: 必要なアクセス権限を持つ IAM グループをセットアップする](sample-codecommit.md#sample-codecommit-permissions)
+ [ステップ 2: AWS CodeCommitにレポジトリを作成する](sample-codecommit.md#sample-codecommit-create-repo)
+ **Amazon S3**。使用するバケットが Amazon S3 にすでにある場合は、[ステップ 2: AWS Cloud9 開発環境の作成、コードリポジトリへの接続、コードのアップロードに進んでください](#codepipeline-repos-connect-to-repo)。それ以外の場合、Amazon S3 を使用するには、Amazon Simple Storage Service ユーザーガイド**の手順をこの順序で実行してから、このトピックに戻ります。
+ [Amazon S3 へのサインアップ](https://docs.aws.amazon.com/AmazonS3/latest/gsg/SigningUpforS3.html)
+ [バケットの作成](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html)
+ **GitHub** GitHub に既にリポジトリがある場合は、そのリポジトリをクローンし、開発環境に[Git パネル](source-control-gitpanel.md)インターフェイスを使って、ローカルコピーを作成します。GitHub でアカウントやリポジトリをまだセットアップしていない場合は、手順については、[関連資料](https://docs.github.com/en/github)を参照してください。
## ステップ 2: AWS Cloud9 開発環境を作成し、コードリポジトリに接続してコードをアップロードする
このステップでは、 AWS Cloud9 コンソールで AWS Cloud9 開発環境を作成します。次に CodePipeline が使用するリポジトリに環境を接続します。最後に、環境の AWS Cloud9 IDE を使用してソースコードをリポジトリにアップロードします。
環境を作成するには、「[環境を作成する](create-environment.md)」の指示に従ってから、このトピックに戻ります。(環境がすでに作成されている場合は、それを使用することができます。 新しく作成する必要はありません。)
環境をリポジトリに接続し、その後ソースコードをリポジトリにアップロードしていない場合にアップロードするには、次の一連の手順のいずれかを使用します。選択するセットはソースコードを保存するリポジトリのタイプによって異なります。
****
| **[Repository type]** | **指示** |
| --- | --- |
| CodeCommit | 「*AWS CodeCommit サンプル*」の指示に従います。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/codepipeline-repos.html) |
| Amazon S3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/codepipeline-repos.html) |
| GitHub | GitHub でホストされているリポジトリをクローンし、[Git パネル](source-control-gitpanel.md)インターフェイスを使って操作できます。 |
環境をリポジトリに接続すると、 AWS Cloud9 IDE からリポジトリにソースコードの変更をプッシュするたびに、CodePipeline はビルド、テスト、デプロイする関連パイプラインを介してそれらの変更を自動的に送信します。関連パイプラインはこのトピックの後半で作成します。
## ステップ 3: を使用する準備をする AWS CodePipeline
このステップでは、[Team Setup](setup.md) で作成または識別した IAM グループに特定の AWS 管理ポリシーをアタッチします。これにより、グループのユーザーによる CodePipeline でのパイプラインの作成および使用が有効になります。
前に CodePipeline を使用したことがある場合は、[ステップ 4: AWS CodePipelineでパイプラインを作成する](#codepipeline-repos-create-pipeline)に進んでください。
このステップでは、「 *AWS CodePipeline ユーザーガイド*」の[「ステップ 3: IAM 管理ポリシーを使用して割り当てる AWS CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-codepipeline.html#assign-permissions)」の手順に従って、このトピックに戻ります。
## ステップ 4: でパイプラインを作成する AWS CodePipeline
このステップでは、このトピックの前半で作成または識別したリポジトリを使用する CodePipeline でパイプラインを作成します。
このステップでは、*AWS CodePipeline ユーザーガイド*の[「 AWS CodePipelineでパイプラインを作成する](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html)A」の指示に従います。
パイプラインが作成された後、 CodePipeline はリポジトリのソースコードの現行バージョンを、構築、テスト、デプロイするため、パイプラインを通して送信します。次に、ソースコードの変更を IDE AWS Cloud9 からリポジトリにプッシュするたびに、CodePipeline はそれらの変更をパイプラインを介して自動的に送信し、構築、テスト、デプロイします。
パイプラインを表示するには、*AWS CodePipeline ユーザーガイド* における [AWS CodePipelineでパイプラインの詳細と履歴](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-view.html) の指示Aに従います。
# Amazon CodeCatalyst の使用
Amazon CodeCatalyst は、ソフトウェア開発チーム向けのクラウドベースのコラボレーションスペースです。CodeCatalyst では、継続的インテグレーション/デリバリー (CI/CD) ツールを使用して、コードでの作業やコラボレーション、アプリケーションの構築、テスト、デプロイを 1 か所で行うことができます。を CodeCatalyst スペースに接続することで、 AWS リソース AWS アカウントをプロジェクトに接続できます。また、CodeCatalyst を使用すると、ソフトウェアを迅速かつ確実に配信できます。CodeCatalyst の詳細については、Amazon CodeCatalyst ガイドの「[What is Amazon CodeCatalyst?](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)」(Amazon CodeCatalyst とは) を参照してください。
開発環境は、プロジェクトのソースリポジトリに保存されているコードを操作するために CodeCatalyst で使用できるクラウドベースの開発環境です。CodeCatalyst で開発環境を作成できます。その間に、サポートされている統合開発環境 (IDE) を使用して、プロジェクト固有の CodeCatalyst でコードに取り組むことができます。または、空の開発環境を作成して、サードパーティのリポジトリからコードを複製し、サポートされている IDE で作業することもできます。
CodeCatalyst コンソールで開発環境にアクセスするために使用される AWS Cloud9 IDE は、 で実行される AWS Cloud9 IDE とは異なります AWS。CodeCatalyst AWS Cloud9 IDE では、CodeCatalyst に自動的にログインし、IDE 内の **aws-explorer** オプションを使用してサービスにアクセスできます。 AWS Toolkit の詳細については、 *AWS Cloud9 ガイド*の [AWS Toolkit for AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/toolkit-welcome.html) を参照してください。
**Topics**
+ [での Amazon CodeCatalyst の開始方法 AWS Cloud9](ide-toolkits-cloud9-getstarted.title.md)
+ [から AWS Cloud9 Amazon CodeCatalyst への移行](c9-replication-cc.md)
+ [レプリケーションツールを使用する](c9-replication-cc-tool.md)
+ [レプリケーションプロセスに関するよくある質問](faqs-replication-tool.md)
+ [Amazon CodeCatalyst の開発環境](devenvironment-cloud9.title.md)
# での Amazon CodeCatalyst の開始方法 AWS Cloud9
このセクションでは、CodeCatalyst の使用を開始する方法の概要を説明します。このセクションのトピックでは、Amazon CodeCatalyst AWS Cloud9 で を使用する方法とCodeCatalyst で環境を AWS Cloud9 レプリケートする方法について説明します。後のトピックでは、CodeCatalyst 開発環境を作成する方法と、IDE AWS Cloud9 を使用して開発環境にアクセスする方法についても説明します。
AWS ツールキットは、 AWS クラウド アカウント、サービス、リソースへの迅速なアクセスを提供する IDE 固有のソフトウェア開発キット (SDKs) です。 AWS Toolkit で CodeCatalyst アカウントから、CodeCatalyst 開発環境、スペース、およびプロジェクトを便利なインターフェイスで表示、編集、管理できます。 AWS Toolkits で利用できる AWS クラウド サービスと機能の詳細については、[「 とは AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html)」、[AWS 「 Toolkit for AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/toolkit-welcome.html)」、[「 とは AWS Toolkit for JetBrains](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html)」を参照してください。ガイド[とは AWS Toolkit for JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html)。
IDE で CodeCatalyst AWS Cloud9 を使用するには、CodeCatalyst コンソール内で作成した既存のスペース、プロジェクト、開発環境が必要です。
**注記**
CodeCatalyst の IDE AWS Cloud9 のファイルシステム内で、同じ名前のフォルダ内に**プロジェクト**という名前のサブフォルダを作成しないでください。このようにすると、このディレクトリ内のどのファイルにもアクセスできなくなります。この問題は、**/projects/projects** のファイルパスに影響します。**/test/projects** や **/projects/test/projects** などのファイルパスは、この問題の影響を受けません。これは既知の問題であり、IDE File Explorer AWS Cloud9 にのみ影響します。
**注記**
現在、CodeCatalyst の IDE AWS Cloud9 のファイルシステムを使用して、同じ名前のフォルダ内に**プロジェクト**という名前のサブフォルダを作成することはできません。 AWS Cloud9 IDE File Explorer からこのディレクトリ内のファイルにアクセスすることはできませんが、コマンドラインを使用してアクセスできます。別のフォルダ名を使用してください。この問題は **/projects/projects** のファイルパスにのみ影響します。**/test/projects** や **/projects/test/projects** などのファイルパスは正常に機能します。これは既知の問題であり、IDE File Explorer AWS Cloud9 にのみ影響します。
# から AWS Cloud9 Amazon CodeCatalyst への移行
AWS Cloud9 CodeCatalyst の は、 とやり取りするためのフルマネージドエクスペリエンスを提供します AWS Cloud9。Amazon CodeCatalyst で現在の AWS Cloud9 コードリソースを手動でレプリケートできます。以下のセクションでは、このプロセスを詳しく説明します。コードリソースを移動して複製するには、CodeCatalyst 内にスペースを作成します。スペースは、会社、部門、またはグループを表します。CodeCatalyst で作成するプロジェクト、メンバー、および関連するクラウドリソースを追加するためのスペースを作成する必要があります。ユーザーがプロジェクトへの招待を受け入れると、CodeCatalyst は自動的にユーザーをスペースに追加します。**Space administrator** ロールを持つユーザーは、スペースを管理できます。
このスペース内にプロジェクトを作成し、ソースリポジトリを追加します。プロジェクトは、開発チームとタスクをサポートする CodeCatalyst のコラボレーションスペースです。プロジェクトを作成したら、リソースを追加、更新、または削除できます。プロジェクトダッシュボードをカスタマイズして、チームの作業の進捗状況を監視することもできます。1 つのスペースに複数のプロジェクトを含めることができます。追加するソースリポジトリの数は、 AWS Cloud9 環境で既に使用しているリポジトリの数によって異なります。このプロジェクトを作成し、該当するソースリポジトリを追加したら、 AWS Cloud9 環境に戻って、環境データを CodeCatalyst の新しいリポジトリにレプリケートする必要がある場合があります。何をするかは、 AWS Cloud9 にあるソースリポジトリのタイプによって異なります。
スペース、プロジェクト、ソースリポジトリを作成したら、開発環境で を使用して CodeCatalyst AWS Cloud9 で環境を起動できます。開発環境はクラウドベースの開発環境です。CodeCatalyst で開発環境を使用して、プロジェクトのソースリポジトリに保存されているコードを操作できます。CodeCatalyst で開発環境を作成して、サポートされている統合開発環境 (IDE) を備えたプロジェクト固有の開発環境でコードを処理することもできます。
レプリケーションツールを使用して、現在の AWS Cloud9 コードリソースを CodeCatalyst にレプリケートすることもできます。これは、環境でダウンロードして実行するツールです AWS Cloud9 。既に CodeCatalyst にサインアップしてスペースを作成した場合、ツールは自動的にこのスペース内にプロジェクトを作成し、コードリソースを CodeCatalyst の新しいリポジトリに複製します。手動レプリケーションプロセスと同様です。これは、 AWS Cloud9 にあるソースリポジトリのタイプによって異なります。例えば、GitHub リポジトリがある場合でも、CodeCatalyst コンソールの **[GitHub 拡張機能]** を使用して、これらのリポジトリを複製する必要があります。
+ [ステップ 1. Amazon CodeCatalyst にサインアップしてスペースを作成する](#c9-replication-cc-space-creation)
+ [ステップ 2. スペースにプロジェクトを作成する](#c9-replication-cc-project-creation)
+ [ステップ 3. プロジェクトにソースリポジトリを作成する](#c9-replication-cc-repo-creation)
+ [Step 4. CodeCatalyst のソースリポジトリに AWS Cloud9 コードリソースを複製する](#c9-replication-cc-source-repo-creation)
+ [ステップ 5. を使用して CodeCatalyst で開発環境を作成する AWS Cloud9](#dev-environment-creation)
## ステップ 1. Amazon CodeCatalyst にサインアップしてスペースを作成する
既存のスペースやプロジェクトへの招待を受けなくても、Amazon CodeCatalyst にサインアップできます。サインアップすると、スペースとプロジェクトが作成されます。使用した既存の AWS アカウント ID を入力できます AWS Cloud9。これは請求目的で AWS アカウント も使用できます。 AWS アカウント ID を検索する方法については、[AWS アカウント 「ID とそのエイリアス](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html)」を参照してください。以下の手順に従って、Amazon CodeCatalyst プロファイルにサインアップし、スペースを作成し、スペースのアカウントを追加します。
**新規ユーザーとしてサインアップするには**
1. [CodeCatalyst コンソール](https://codecatalyst.aws/)を開きます。
1. [Welcome] ページで、**[サインアップ]** を選択します。
** AWS ビルダー ID の作成**ページが表示されます。 AWS ビルダー ID は、サインインするために作成する ID です。この ID は AWS アカウント ID と同じではありません。 AWS ビルダー ID の詳細については、*AWS 「サインインユーザーガイド*」の[AWS 「ビルダー ID およびその他の AWS 認証情報](https://docs.aws.amazon.com/signin/latest/userguide/differences-aws_builder_id.html)」を参照してください。
1. **[メールアドレス]** に、CodeCatalyst に関連付けるメールアドレスを入力します。その後、**[Next]** を選択します。
1. **名前に**、 AWS ビルダー ID を使用するアプリケーションに表示する名前と姓を入力します。
この名前は AWS Builder ID プロファイル名です。必要に応じて、後で名前を変更できます。
[**次へ**] を選択します。**[E メール確認]** ページが表示されます。指定した E メールアドレスに確認コードが送信されます。
1. **[確認コード]** に、受信したコードを入力し、**[確認]** を選択します。
5 分経ってもコードが届かず、スパムまたは迷惑メールフォルダーにもコードが見つからない場合は、**[コードを再送信]** を選択します。
1. コードが確認されたら、パスワードを入力して、**[パスワードの確認]** を選択します。
カスタマーアグリーメントと AWS サービス条件を読み、同意 AWS したことを確認するチェックボックスを選択し、**プロファイルの作成**を選択します。
1. **[エイリアスの作成]** ページで、CodeCatalyst で使用するエイリアスを入力します。他の CodeCatalyst ユーザーは、コメントやプルリクエストであなたを @mention するために、このエイリアスを使用します。CodeCatalyst プロファイルには、 AWS ビルダー ID のフルネームと CodeCatalyst エイリアスの両方が含まれます。CodeCatalyst エイリアスを変更することはできません。
フルネームとエイリアスは、CodeCatalyst のさまざまな領域に表示されます。例えば、アクティビティフィードにはプロファイル名が表示されますが、プロジェクトメンバーはあなたのエイリアスを使用してあなたを @mention します。
**[エイリアスの作成]** を選択します。ページが更新され、**[スペースの作成]** セクションが表示されます。
1. **[スペース名]** にスペースの名前を入力し、**[次へ]** を選択します。
この名前を変更することはできません。
1. **[AWS アカウント ID]** には、スペースに接続するアカウントの 12 桁の ID をリンクします。
**[AWS アカウント 検証トークン]** に、生成されたトークン ID をコピーします。トークンは自動的にコピーされます。ただし、 AWS 接続リクエストの承認中に保存することもできます。
1. **Verify in AWS** を選択します。
1. **[Amazon CodeCatalyst スペースの確認]** ページが AWS マネジメントコンソール で開きます。
これは **[Amazon CodeCatalyst スペース]** ページです。ページにアクセスするには、ログインが必要な場合があります。
このページにアクセスするには、[AWS マネジメントコンソール](https://console.aws.amazon.com/codecatalyst/home/) にある Amazon CodeCatalyst スペースにサインインします。
の検証トークンフィールド AWS マネジメントコンソール には、CodeCatalyst で生成されたトークンが自動的に入力されます。
1. **[スペースを確認]** を選択します。
**アカウント確認**成功メッセージが表示され、アカウントがスペースに追加されたことを示します。
デフォルトでは、CodeCatalyst の無料利用枠を使用します。変更したい場合は、**[このスペースについてスタンダードティアを有効にするか、IAM ロールを追加するには、スペースの詳細を表示します]** を選択します。
CodeCatalyst の料金レベルの詳細については、「[Amazon CodeCatalyst - 料金表](https://codecatalyst.aws/explore/pricing)」を参照してください。
**[CodeCatalyst スペースの詳細]** ページが AWS マネジメントコンソール で開きます。これは **[Amazon CodeCatalyst スペース]** ページです。ページにアクセスするには、ログインが必要な場合があります。
1. **[[Amazon CodeCatalyst](https://codecatalyst.aws/) に移動]** を選択します。
1. CodeCatalyst の作成ページで、**[スペースの作成]** を選択します。
スペースの作成中は、ステータスメッセージが表示されます。スペースが作成されると、CodeCatalyst はそのスペースのページを開きます。ビューのデフォルトは **[プロジェクト]** タブに設定されています。
**注記**
アクセス許可エラーまたはバナーが表示された場合は、ページを更新してページをもう一度表示してみてください。
CodeCatalyst にサインアップしてスペースを作成したら、レプリケーションプロセスの次のステップは、このスペース内にプロジェクトを作成することです。
## ステップ 2. スペースにプロジェクトを作成する
以下のステップは、前のステップで作成したスペースに空のプロジェクトを作成する方法の概要です。このプロジェクトでは、後で必要なリソースを手動で追加できます。プロジェクトを作成する前に、*Space administrator* ロールを持っている必要があります。また、プロジェクトを作成するスペースに参加する必要があります。スペースを作成すると、CodeCatalyst は自動的に *Space administrator* ロールを割り当てます。*Space administrator* ロールは CodeCatalyst で最も強力なロールです。このロールとそのアクセス許可の詳細については、「[Space administrator ロール](https://docs.aws.amazon.com/codecatalyst/latest/userguide/welcome.html)」を参照してください。
**空のプロジェクトを作成するには**
1. プロジェクトを作成するスペースに移動します。
1. スペースダッシュボードで、**[プロジェクトの作成]** を選択します。
1. **[最初から開始]** を選択します。
1. **[プロジェクトに名前を付ける]** に、プロジェクトに割り当てる名前を入力します。名前はスペース内で一意でなければなりません。
1. **[プロジェクトを作成]** を選択します。
プロジェクトを作成したら、レプリケーションプロセスの次のステップは、1 つ以上のソースリポジトリを作成することです。
## ステップ 3. プロジェクトにソースリポジトリを作成する
作成したプロジェクト内に、ソースリポジトリを作成する必要があります。このリポジトリには **README.md** ファイルという 1 つのファイルが含まれており、いつでも編集または削除できます。ソースリポジトリを作成したときに行った選択によっては、`.gitignore` ファイルも含まれる場合があります。
**ソースリポジトリを作成するには**
1. [CodeCatalyst コンソール](https://codecatalyst.aws/)を開きます。
1. プロジェクトに移動します。
1. ナビゲーションペインで **[コード]** を選択してから、**[ソースリポジトリ]** を選択します。
1. **[リポジトリの追加]** を選択し、**[リポジトリの作成]** を選択します。
1. **[リポジトリ名]** で、リポジトリの名前を指定します。
リポジトリ名は、プロジェクト内で一意である必要があります。リポジトリ名の要件の詳細については、「[CodeCatalyst のソースリポジトリのクォータ](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-quotas.html)」を参照してください。
1. (オプション) **[説明]** に、プロジェクト内の他のユーザーがリポジトリの用途を理解しやすいように、リポジトリの説明を追加します。
1. (オプション) プッシュする予定のコードの種類に応じた `.gitignore` ファイルを追加します。
1. **[作成]** を選択します。
**注記**
CodeCatalyst は、ユーザーがリポジトリを作成するときに、`README.md` ファイルをリポジトリに追加します。また、CodeCatalyst は **main** という名前のデフォルトブランチにリポジトリの初期コミットを作成します。README.md ファイルは編集または削除できますが、デフォルトブランチを変更または削除することはできません。
1. ソースリポジトリのクローン URL と PAT を取得するには、**[クローンリポジトリ]** を選択します。
1. HTTPS クローン URL と PAT をそれぞれコピーするには、**[コピー]** を選択します。次に、クローン URL と PAT を、検索できる場所に保存します。
クローン URL と PAT はステップ 4 で使用され、`CODECATALYST_SOURCE_REPO_CLONE_URL` および `CODECATALYST_PAT` として参照されます。
プロジェクト内にソースリポジトリを作成したら、このソースリポジトリに AWS Cloud9 データを複製します。
## ステップ 4. CodeCatalyst のソースリポジトリへの AWS Cloud9 コードリソースのレプリケート
AWS Cloud9 環境内のソースリポジトリのタイプによって、作成した CodeCatalyst ソースリポジトリにコードリソースを取得するためのレプリケーション方法が決まります。オプションは以下のとおりです:
+ [でのGitHubリポジトリの使用 AWS Cloud9](#c9-replication-cc-source-repo-creation-github)
+ [GitLab GitHubや Bitbucket などの 以外の リポジトリを で使用する AWS Cloud9](#c9-replication-cc-source-repo-creation-nongithub)
+ [AWS Cloud9 で空のリポジトリを使用する](#c9-replication-cc-source-norepo-creation)。このオプションは、 AWS Cloud9 でソースリポジトリを使用しないことを意味します。
### CodeCatalyst で GitHub リポジトリを使用する
**GitHub リポジトリ**拡張機能を使用すると、Amazon CodeCatalyst プロジェクトの AWS Cloud9 からリンクされたGitHubリポジトリを使用できます。以下のステップは、CodeCatalyst カタログから GitHub 拡張機能をインストールする方法の概要です。また、これらのステップは、既存の GitHub アカウントを CodeCatalyst スペースに接続し、GitHub リポジトリを CodeCatalyst プロジェクトにリンクする方法も示しています。
この方法の最初のステップは、CodeCatalyst カタログから **[GitHub リポジトリ]** 拡張機能をインストールすることです。この拡張機能をインストールするには、以下のステップを実行します。
**重要**
**[Github リポジトリ]** 拡張機能のインストールと設定の一環として、拡張機能を GitHub アカウントにインストールする必要があります。そのためには、GitHub アカウント管理者と CodeCatalyst スペース管理者である必要があります。
**ステップ 1. CodeCatalyst カタログから拡張機能をインストールするには**
1. [CodeCatalyst コンソール](https://codecatalyst.aws/)を開きます。
1. 自分のスペースに移動します。
**ヒント**
複数のスペースに所属している場合は、表示するスペースを上部のナビゲーションバーで選択できます。
1. 検索バーの横にある上部のメニューバーの **[カタログ]** アイコンを選択して、CodeCatalyst カタログに移動します。**[GitHub リポジトリ]** を検索するか、カテゴリに基づいて拡張機能をフィルタリングできます。
1. (オプション) 関連するアクセス許可など、拡張機能の詳細を確認するには、**[GitHub リポジトリ]** 拡張名を選択します。
1. **[インストール]** を選択します。拡張機能に必要なアクセス許可を確認し、続行する場合は、**[インストール]** を再度選択します。
**[GitHub リポジトリ]** 拡張をインストールすると、**[GitHub リポジトリ]** 拡張機能の詳細ページが表示され、接続された GitHub アカウントとリンクされた GitHub リポジトリを表示および管理できます。
**[GitHub リポジトリ]** 拡張機能をインストールしたら、GitHub アカウントを CodeCatalyst スペースに接続します。GitHub アカウントを接続するには、以下のステップを実行します。
**ステップ 2. GitHub アカウントを CodeCatalyst に接続するには**
1. **[接続済み Github アカウント]** タブで、**[GitHub アカウントを接続]** を選択して、GitHub の外部サイトに移動します。
1. GitHub 認証情報を使用して GitHub アカウントにサインインし、Amazon CodeCatalyst をインストールするアカウントを選択します。
1. CodeCatalyst に現在および将来のすべてのリポジトリへのアクセスを許可するかどうかを選択します。または、CodeCatalyst で使用する特定の GitHub リポジトリを選択します。デフォルトのオプションは、GitHub スペース内のすべての GitHub リポジトリです。
1. CodeCatalyst に付与されているアクセス許可を確認してから、**[インストール]** を選択します。
GitHub アカウントを CodeCatalyst に接続すると、**[GitHub リポジトリ]** 拡張機能の詳細ページの **[GitHub アカウント]** タブで、接続されたアカウントを確認できます。
CodeCatalyst で GitHub リポジトリを使用するための最後のステップは、リポジトリを使用する CodeCatalyst プロジェクトにリポジトリをリンクすることです。GitHub リポジトリを CodeCatalyst プロジェクトにリンクするには、プロセス全体のステップ 3 で説明されている以下のステップを実行します。
**ステップ 3. GitHub リポジトリ拡張機能の詳細ページから GitHub リポジトリを CodeCatalyst プロジェクトにリンクするには**
1. **[リンクされた GitHub リポジトリ]** タブで、**[GitHub リポジトリをリンク]** を選択します。
1. **[GitHub アカウント]** として、リンクするリポジトリを含む GitHub アカウントを選択します。
1. **[GitHub リポジトリ]** として、CodeCatalyst プロジェクトにリンクするリポジトリを選択します。
1. **[CodeCatalyst プロジェクト]** として、GitHub リポジトリをリンクする CodeCatalyst プロジェクトを選択します。
1. [**Link (リンク)**] を選択します。
これで、CodeCatalyst リポジトリには、プッシュしたばかりの更新されたファイルとコミットが保存されているはずです。これで、このブランチから開発環境を作成して、 AWS Cloud9 で開くことができます。開発環境の詳細については、「[CodeCatalyst の開発環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)」を参照してください。
これで、このブランチから開発環境を作成して、 AWS Cloud9 で開くことができます。これを行う手順については、[「ステップ 5: CodeCatalyst AWS Cloud9 で を使用して開発環境を作成する](#dev-environment-creation)」で説明しています。
### CodeCatalyst で GitHub 以外のリポジトリを使用する
以外のGitHubリポジトリ AWS Cloud9 を使用して環境をレプリケートする前に、Amazon CodeCatalyst で個人用アクセストークン (PAT) を作成する必要があります。次のセクションでは、このトークンの作成方法の概要を説明します。
#### Amazon CodeCatalyst で個人アクセストークンを作成する
プロジェクトで作成したソースリポジトリには、Git クライアントのあるローカルコンピューターまたは統合開発環境 (IDE) でアクセスできます。そのためには、アプリケーション固有のパスワードを入力する必要があります。この目的で使用する個人アクセストークン (PAT) を作成できます。作成した個人アクセストークン (PAT) は、CodeCatalyst のすべてのスペースとプロジェクトのユーザー ID に関連付けられます。作成した PAT の名前と有効期限を表示したり、不要になった PAT を削除したりできます。PAT シークレットは、作成時にのみコピーできます。
**個人アクセストークン (PAT) を作成するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 上部のメニューバーでプロファイルバッジを選択し、**[My 設定]** を選択します。
**ヒント**
ユーザープロファイルも確認できます。これを行うには、プロジェクトまたはスペースのメンバーページで、メンバーリストから自分の名前を選択します。
1. **[個人アクセストークン]** で **[作成]** を選択します。
1. **[PAT 名]** に、個人アクセストークン (PAT) のわかりやすい名前を入力します。
1. **[有効期限]** では、デフォルトの日付のままにしておくか、カレンダーアイコンを選択して、カスタムの日付を選択します。有効期限のデフォルトは、現在の日付から 1 年です。
1. **[作成]** を選択します。
**ヒント**
このトークンは、ソースリポジトリの **[クローンリポジトリC]** を選択したときにも作成できます。
1. PAT シークレットをコピーするには、**[コピー]** を選択します。PAT シークレットを、検索できる場所に保存します。
**重要**
PAT シークレットは 1 回だけ表示されます。ウィンドウを閉じると、再表示できなくなります。PAT シークレットを安全な場所に保存しなかった場合は、別のシークレットを作成できます。
ソースリポジトリの PAT を作成したら、以下のセクションで説明するように、 AWS Cloud9 環境にリモートリポジトリを追加し、このリポジトリにデータをプッシュして、 AWS Cloud9 環境から CodeCatalyst にデータをレプリケートします。
#### AWS Cloud9 環境にリモートリポジトリを追加する
GitHub リポジトリではないリポジトリを実行しているとします。 AWS Cloud9 環境にリモートリポジトリを追加し、CodeCatalyst のソースリポジトリにデータをプッシュできます。このプロセスを完了するには、以下のコマンドを実行します。
IDE AWS Cloud9 内から、CodeCatalyst のレプリケーションプロセスのステップ 3 で作成したソースリポジトリを指すリモートリポジトリを追加します。コマンドの `CODECATALYST_SOURCE_REPO_CLONE_URL` を、[ステップ 3 のステップ 10 で保存したクローン URL に置き換えます。プロジェクトにソースリポジトリを作成する](#c9-replication-cc-repo-creation)
```
git remote add codecatalyst CODECATALYST_SOURCE_REPO_CLONE_URL
```
次のコマンドを使用して、新しいブランチをソースリポジトリにプッシュします。パスワードの入力を求められたら、[ステップ 3 のステップ 10 で保存した `CODECATALYST_PAT` パスワードを使用します。プロジェクトにソースリポジトリを作成する](#c9-replication-cc-repo-creation)
```
git checkout -b replication && git push codecatalyst replication
```
以下は、このコマンドを実行したときの出力の例を示しています。
```
Switched to a new branch 'replication'
Password for 'https://[aws-account-id]@[aws-region].codecatalyst.aws/v1/MySpace222581768915/Replication/Repository':
Enumerating objects: 4, done.
Counting objects: 100% (4/4), done.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (4/4), 982 bytes | 122.00 KiB/s, done.
Total 4 (delta 0), reused 0 (delta 0), pack-reused 0
remote: Validating objects: 100%
To https://[aws-account-id].codecatalyst.aws/v1/MySpace222581768915/Replication/Repository
* [new branch] replication → replication
```
```
```
このブランチは、CodeCatalyst で作成したソースリポジトリにあります。このブランチから開発環境を作成して、 AWS Cloud9 で開くことができます。開発環境の詳細については、「[CodeCatalyst の開発環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)」を参照してください。
これで、このブランチから開発環境を作成して、 AWS Cloud9 で開くことができます。これを行う手順については、[「ステップ 5: CodeCatalyst AWS Cloud9 で を使用して開発環境を作成する](#dev-environment-creation)」で説明しています。
#### で空のリポジトリを使用する AWS Cloud9
空のリポジトリ AWS Cloud9 を使用して から環境をレプリケートする前に、まず Amazon CodeCatalyst で個人用アクセストークン (PAT) を作成します。次のセクションでは、このトークンの作成方法の概要を説明します。
##### Amazon CodeCatalyst で個人アクセストークンを作成する
プロジェクトで作成したソースリポジトリには、Git クライアントのあるローカルコンピューターまたは統合開発環境 (IDE) でアクセスできます。そのためには、アプリケーション固有のパスワードを入力する必要があります。この目的で使用する個人アクセストークン (PAT) を作成できます。作成した個人アクセストークン (PAT) は、CodeCatalyst のすべてのスペースとプロジェクトのユーザー ID に関連付けられます。作成した PAT の名前と有効期限を表示したり、不要になった PAT を削除したりできます。PAT シークレットは、作成時にのみコピーできます。
**個人アクセストークン (PAT) を作成するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 上部のメニューバーでプロファイルバッジを選択し、**[My 設定]** を選択します。
**ヒント**
ユーザープロファイルも確認できます。これを行うには、プロジェクトまたはスペースのメンバーページで、メンバーリストから自分の名前を選択します。
1. **[個人アクセストークン]** で **[作成]** を選択します。
1. **[PAT 名]** に、個人アクセストークン (PAT) のわかりやすい名前を入力します。
1. **[有効期限]** では、デフォルトの日付のままにしておくか、カレンダーアイコンを選択して、カスタムの日付を選択します。有効期限のデフォルトは、現在の日付から 1 年です。
1. **[作成]** を選択します。
**ヒント**
このトークンは、ソースリポジトリの **[クローンリポジトリC]** を選択したときにも作成できます。
1. PAT シークレットをコピーするには、**[コピー]** を選択します。PAT シークレットを、検索できる場所に保存します。
**重要**
PAT シークレットは 1 回だけ表示されます。ウィンドウを閉じると、再表示できなくなります。PAT シークレットを安全な場所に保存しなかった場合は、別のシークレットを作成できます。
ソースリポジトリの PAT を作成したら、以下のセクションで説明するように、 AWS Cloud9 環境で空のリポジトリを開始し、CodeCatalyst で作成したソースリポジトリをポイントして、 AWS Cloud9 環境から CodeCatalyst にデータをレプリケートします。
##### で空のリポジトリを開始する AWS Cloud9
に設定されているソースリポジトリがない場合は AWS Cloud9、 で空のリポジトリを開始します AWS Cloud9。さらに、CodeCatalyst で作成したソースリポジトリを指定し、Git を通じて複製するファイルを追加してプッシュします。以下のステップを実行し、次のコマンドを実行して AWS Cloud9 、ファイルを CodeCatalyst にレプリケートします。
1. AWS Cloud9 環境から、次のコマンドを実行して空のリポジトリを開始します。
```
git init -b main
```
すると、次に示すような出力が表示されます。
```
Initialized empty Git repository in /home/ec2-user/environment/.git/
```
1. CodeCatalyst からソースリポジトリの URL をクローンします。CodeCatalyst コンソール内で作成した CodeCatalyst プロジェクトに移動し、ナビゲーションペインで **[コード]** を選択し、**[ソースリポジトリ]** を選択します。
1. ソースリポジトリのリストから必要なリポジトリを選択し、**[クローンリポジトリ]** を選択して、クローン URL をコピーします。
1. クローンした URL を使用して CodeCatalyst リポジトリを追加し、既に空のリポジトリにあるコンテンツを CodeCatalyst にプッシュします。
```
git remote add origin [...]
git push origin --force
```
1. 複製するファイルを追加します。環境ディレクトリ内のすべてのファイルを複製する場合は、`git add -A` を実行します。
```
git add -A .
git commit -m "replicate"
```
1. 関連性のない 2 つの履歴をマージします。マージコンフリクトが発生した場合の対処:
```
git merge origin/main --allow-unrelated-histories
```
1. 次のコマンドを実行して、変更を CodeCatalyst のソースリポジトリにプッシュバックします。パスワードの入力を求められたら、[ステップ 3 のステップ 10 で生成した個人アクセストークン (`CODECATALYST_PAT`) を入力します。プロジェクトにソースリポジトリを作成する](#c9-replication-cc-repo-creation)
```
Admin:~/environment (main) $ git push origin main
Password for 'https://222581768915@git.us-west-2.codecatalyst.aws/v1/MySpace222581768915/Replication/Replication':
```
この手順を完了すると、CodeCatalyst リポジトリには、プッシュしたばかりの更新されたファイルとコミットが格納されます。これで、このブランチから開発環境を作成して、 AWS Cloud9 で開くことができます。そのためのステップは、次のセクションで概説されています。
## ステップ 5: CodeCatalyst AWS Cloud9 で を使用して開発環境を作成する
次の手順では、 AWS Cloud9 と先ほどレプリケートしたデータを使用して CodeCatalyst で開発環境を作成する方法の概要を説明します。
**を使用して開発環境を作成するには AWS Cloud9**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 開発環境を作成するプロジェクトに移動します。
1. ナビゲーションペインで、**[概要]** を選択し、次に **[My 開発環境]** セクションに移動します。
1. **[開発環境を作成]** を選択します。
1. ドロップダウンメニュー AWS Cloud9 から を選択します。
1. **[リポジトリのクローン]** を選択します。
**注記**
現在、CodeCatalyst はサードパーティのリポジトリのクローニングをサポートしていませんが、開発環境を作成して、選択した IDE からサードパーティのリポジトリをその中にクローンすることはできます。
1. 次のいずれかを行います。
1. クローンするリポジトリを選択し、**[既存のブランチで作業する]** を選択し、**[既存のブランチ]** ドロップダウンメニューからブランチを選択します。
1. クローンするリポジトリを選択し、**[新しいブランチで作業する]** を選択し、**[ブランチ名]** フィールドにブランチ名を入力し、**[ブランチの作成元]** ドロップダウンメニューから新しいブランチを作成するブランチを選択します。
1. オプションで、開発環境のエイリアスを追加します。
1. オプションで、**[開発環境設定]** 編集ボタンを選択して、開発環境のコンピューティング、ストレージ、またはタイムアウト設定を編集します。
1. **[作成]** を選択します。開発環境の作成中は、開発環境のステータス列に **[開始中]** と表示され、開発環境が作成されると、ステータス列に **[実行中]** と表示されます。
# レプリケーションツールを使用する
AWS Cloud9 CodeCatalyst の は、 とやり取りするためのフルマネージドエクスペリエンスを提供します AWS Cloud9。お客様が CodeCatalyst AWS Cloud9 で を使用できるように、レプリケーションツールを作成しました。 AWS Cloud9 環境でスクリプトをコピーして実行したら、プロンプトに従ってスクリプトを実行し、コードリソースを から CodeCatalyst AWS Cloud9 にレプリケートします。レプリケーションツールとプロセスの詳細については、以下に概説する「[レプリケーションプロセスに関するよくある質問](https://docs.aws.amazon.com/cloud9/latest/user-guide/faqs-replication-tool)」を参照してください。
**注記**
このレプリケーションプロセスは、既存の AWS Cloud9 環境には影響しません。レプリケーションプロセスが完了すると、開発環境、ソースリポジトリ、プロジェクト、スペースを削除でき、 AWS Cloud9 環境には影響しません。このツールはコードリソースを CodeCatalyst AWS Cloud9 の にのみコピーし、既存の AWS Cloud9 環境を削除または設定しません。このレプリケーションツールは、最初に選択された AWS アカウントのグループにリリースされました。その結果、特定の AWS アカウントに表示されない場合があります。
**注記**
ツールをダウンロードする前に、Amazon CodeCatalyst にサインアップしてスペースを作成することをお勧めします。CodeCatalyst へのサインアップの詳細については、「[Amazon CodeCatalyst へのサインアップとスペースの作成](c9-replication-cc.md#c9-replication-cc-space-creation)」を参照してください。
## Amazon CodeCatalyst AWS Cloud9 で を使用する利点
次のセクションでは、CodeCatalyst AWS Cloud9 で を使用する際に得られるパフォーマンス上の利点と機能強化の概要を説明します。
+ CodeCatalyst は、フルマネージド型の開発環境を使用して、ソフトウェア開発ライフサイクル全体を 1 か所から管理できる統合エクスペリエンスを提供します。
+ 起動時の Amazon EBS ボリュームサイズのオプションが強化されました。
+ エフェメラル環境をサポートし、開発環境のコンピューティングをオンデマンドでスケールできるようになりました。
+ カスタムイメージの指定によりカスタム AMI がサポートされます。
+ Devfile のサポートにより、設定をコードとして記述できます。
## レプリケーションツールを使用して CodeCatalyst で AWS Cloud9 コードリソースをレプリケートする
次の手順では、レプリケーションツールをコピーして実行し、レプリケーションプロセスを完了する方法について詳しく説明します。
1. 以下のスクリプトをコピーして、必ず AWS Cloud9 環境内で実行してください。
```
curl https://dx5z5embsyrja.cloudfront.net -o /tmp/replicate-tool.tar.gz && tar --no-same-owner --no-same-permissions -xvf /tmp/replicate-tool.tar.gz -C /tmp && node /tmp/cloud9-replication-tools
```
1. *[オプション]* レプリケーションツールはユーザーの AWS アカウント ID を使用してテレメトリを行います。これは、ツールの使用中に発生する可能性のある問題をより適切に特定できるようにすることを目的としています。`tool starts`、`tool fails`、`tool is cancelled by user`、`tool completes successfully`、および `tool creates a Dev Environment for the user` についてテレメトリイベントを送信します。レプリケーションツールでテレメトリを無効にする場合は、後述の「[レプリケーションツールのテレメトリを無効にする](#disable-telemetry)」を参照してください。
1. AWS Cloud9 環境でレプリケーションツールをコピーして実行したら、ブラウザでアクセス URL に移動し、10 分以内に*許可*をクリックして、 を AWS アカウント AWS ビルダー ID にリンクする必要があります。リンクは一度だけ開いてください。複数回開くとエラーが発生し、最初からやり直す必要があります。 AWS Builder ID の詳細については、[「サインインユーザーガイド」の AWS 「Builder ID を使用した](https://docs.aws.amazon.com/signin/latest/userguide/sign-in-aws_builder_id.html)サインイン」を参照してください。 *AWS *これにより、CodeCatalyst でコードリソースを複製する目的でレプリケーションツールがコードリソースにアクセスできるようになります。
1. 使用するスペースを選択します。スペースが 1 つしかない場合は、そのスペースが選択されます。スペースの詳細については、『*Amazon CodeCatalyst ユーザーガイド*』の「[CodeCatalyst のスペース](https://docs.aws.amazon.com/codecatalyst/latest/userguide/spaces.html)」を参照してください。
1. CodeCatalyst でコードを複製するか、新しい開発環境で試すかを選択します。CodeCatalyst でコードを直接複製することをお勧めします。開発環境の詳細については、『*Amazon CodeCatalyst ユーザーガイド*』の「[CodeCatalyst の開発環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)」を参照してください。
1. プロジェクトの名前を入力するか、Enter キーを押して指定されたデフォルトの名前を使用します。
1. プロンプトが表示されたら、CodeCatalyst の新しいソースリポジトリにファイルをコピーする方法を選択します。ルートフォルダーを単一の CodeCatalyst リポジトリにプッシュするか、サブフォルダーを別の CodeCatalyst リポジトリにプッシュするかを選択できます。
1. ツールが完成したら、ターミナルメッセージに記載されている URL から CodeCatalyst コンソール内のプロジェクトに移動し、CodeCatalyst のコードリソースにアクセスします。
この手順を完了すると、CodeCatalyst リポジトリには、プッシュしたばかりの更新されたファイルとコミットが格納されます。これで、このブランチから開発環境を作成して、 AWS Cloud9 で開くことができます。
## レプリケーションツールのテレメトリを無効にする
以下のステップは、環境変数を設定してレプリケーションツールのテレメトリを無効にする方法の概要です。
1. AWS Cloud9 環境でターミナルを開く
1. 次のコマンドのいずれかを実行します。
```
export CLOUD9_REPLICATION_TOOL_TELEMETRY=off
```
または
```
export CLOUD9_REPLICATION_TOOL_TELEMETRY=0
```
1. 上記のコマンドのいずれかを実行すると、環境変数が設定され、レプリケーションツールのテレメトリが無効になります。テレメトリを無効にした後、レプリケーションツールのスクリプトをコピーして再実行し、プロセスを開始する必要があります。
## レプリケーションツールのフィードバック
問題が発生した場合や、レプリケーションツールの使用経験についてフィードバックしたい場合は、サポートケースを作成して送信してください。サポートケースの作成については、「[サポートケースの作成とケース管理](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)」を参照してください。
## AWS Cloud9 と Amazon CodeCatalyst の違い
次の表は、CodeCatalyst AWS Cloud9 での AWS Cloud9 と の違いの一部を示しています。
| AWS Cloud9 | AWS Cloud9 Amazon CodeCatalyst での |
| --- | --- |
| プライベート VPC は非常にうまく機能します AWS Cloud9。 | プライベート VPC の使用は、現在 CodeCatalyst の AWS Cloud9 ではサポートされていません。 |
| AWS Cloud9 は、事前設定された AWS マネージド認証情報をサポートします。 | CodeCatalyst AWS Cloud9 で の認証情報を手動で設定する必要があります。 |
| 30 分から 7 日間の間隔を設定し、 でシャットダウンを無効にすることができます AWS Cloud9。 | CodeCatalyst では、 の間隔を 15 分から 20 時間 AWS Cloud9 に設定でき、シャットダウンを無効にすることはできません。 |
| AWS Cloud9 は Ubuntu および AL2 OS プラットフォームをサポートしています。 | AWS Cloud9 CodeCatalyst の は、Ubuntu と AL2 を含む MDE ユニバーサルイメージとカスタムイメージをサポートしています。この詳細については、「*Amazon CodeCatalyst ユーザーガイド*」の「[Universal devfile images](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-universal-image.html)」を参照してください。 |
| アップロードとダウンロードは でサポートされています AWS Cloud9 | 現在、CodeCatalyst AWS Cloud9 での のアップロードとダウンロードはサポートされていません。ユーザーは Amazon S3 バケットを使用してアップロードおよびダウンロードする必要があります。 |
| コラボレーションは で利用できます。 AWS Cloud9 | コラボレーションは現在、CodeCatalyst の AWS Cloud9 では使用できません。 |
# レプリケーションプロセスに関するよくある質問
次のセクションでは、レプリケーションツールとレプリケーションプロセスに関するよくある質問のいくつかに回答します。
**質問:** CodeCatalyst で AWS Cloud9 環境をレプリケートした場合、 AWS Cloud9 環境は影響を受けますか?
**回答:** いいえ、環境のレプリケーションは CodeCatalyst AWS Cloud9 のコードリソースのみを にコピーし、作業を継続できるようにします。のコードリソースと環境は、いかなる方法でも影響を受け AWS Cloud9 ません。
**質問:** ロールバックする場合、 AWS Cloud9 環境は影響を受けますか?
**回答:** いいえ。CodeCatalyst 開発環境、ソースリポジトリ、プロジェクト、およびスペースを削除しても、 AWS Cloud9 環境に影響はありません。
**質問:** 新しい拠点は HIPAA や SOC などの規格に準拠していますか?
**回答:** CodeCatalyst の開発環境は現在、これらの標準に準拠していません。これらの規格への準拠は今後予定されています。
**質問:** コードリソースはどこに行きますか?
**回答:** コードリソースは CodeCatalyst のプロジェクト内のソースリポジトリにコピーされます。
**質問:** 使用量は制限されますか?
**回答:** レプリケーションプロセスの一環として、無料利用枠内で 16 GB の開発環境を作成します。つまり、最大 4 つの開発環境を持つことができます。料金、ストレージ、および利用可能なさまざまな料金レベルの詳細については、「[Amazon CodeCatalyst - 料金表](https://codecatalyst.aws/explore/pricing)」を参照してください。
**質問:** コンピューティングはどこに行きますか?
**回答:** 既存のコンピューティングに変更はありません。現状のままです。
**質問:** CodeCatalyst で既存の AWS アカウント認証情報を使用できますか? それらの認証情報は自動的に転送されますか?
**回答:** CodeCatalyst で AWS アカウント認証情報を手動で設定できます。自動的に転送されません。
**質問:** どれくらいの費用がかかりますか?
**回答:** CodeCatalyst は無料で使い始めることができます。料金、ストレージ、および利用可能なさまざまな料金レベルの詳細については、「[Amazon CodeCatalyst - 料金表](https://codecatalyst.aws/explore/pricing)」を参照してください。
**質問:** CodeCatalyst のデータ複製プロセスとデータストレージは安全ですか?
**回答:** はい。コードリソースをコピーするには git push と https を使用します。CodeCatalyst はデータをサービス内に安全に保存します。すべてのデータは、転送時と保管時のいずれも暗号化されます。CodeCatalyst におけるデータ保護の詳細については、『*Amazon CodeCatalyst ユーザーガイド*』の「[Amazon CodeCatalyst におけるデータ保護](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)」を参照してください。
**質問:** どのレプリケーション方法を選択すればよいですか?
**回答:** レプリケーションツールには 2 つのアプローチがあります。コードリソース AWS Cloud9 を から CodeCatalyst にコピーするには、単一の CodeCatalyst ソースリポジトリにプッシュするか、各サブフォルダを個別の CodeCatalyst ソースリポジトリに変換します。ソースリポジトリなど、CodeCatalyst の概念に関する予備知識を必要としないため、最初の方法を使用することをお勧めします。このアプローチは、 AWS Cloud9 で使い慣れているのと同様のセットアップでで作業しながら、CodeCatalyst での AWS Cloud9 の使い方を調べる良い出発点となります。
2 番目のオプションは、ルート AWS Cloud9 環境フォルダの下にあるサブフォルダを個別に使用する場合に最適です。このアプローチでは、ルートフォルダーの下にあるファイルは複製されません。CodeCatalyst のソースリポジトリの詳細については、『*Amazon CodeCatalyst ユーザーガイド*』の「[CodeCatalyst のソースリポジトリ](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source.html)」を参照してください。
**質問:** レプリケーションプロセスで生成される個人アクセストークンはどのようなもので、なぜ必要なのですか? 紛失した場合、再度生成することはできますか？
**回答:** 個人アクセストークンは CodeCatalyst のユーザー ID に関連付けられます。ローカルの変更を git で CodeCatalyst ソースリポジトリにプッシュするときのパスワードとして必要です。トークンとその生成方法の詳細については、『*Amazon CodeCatalyst ユーザーガイド*』の「[Amazon CodeCatalyst での個人アクセストークンの管理](https://docs.aws.amazon.com/codecatalyst/latest/userguide/ipa-tokens-keys.html)」を参照してください。
**質問:** レプリケーションプロセス中にエラーが発生した場合はどうなりますか?
**回答:** レプリケーションツールの使用中にエラーが発生した場合は、まずツールをもう一度試してください。エラーがソースリポジトリに関するものである場合は、複製されたコードリソースを CodeCatalyst ソースリポジトリに手動でプッシュできます。ローカルリポジトリはすでに CodeCatalyst アップストリームで動作するように設定されているので、これでうまくいくはずです。問題が解決しない場合は、サポートケースを作成して送信してください。サポートケースの作成については、「[サポートケースの作成とケース管理](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)」を参照してください。
**質問:** my AWS BuilderID を使用してレプリケーションツールを認証し、アクセス許可を付与する必要があるのはなぜですか?
**回答:** レプリケーションプロセス中、レプリケーションツールが CodeCatalyst 内の複数のリソース (プロジェクト、開発環境、ソースリポジトリ) を読み書きし、ユーザーに代わってローカルコンテンツをコピーする必要があるため、これを行うユーザーのアクセス許可が必要です。
**質問:** CodeCatalyst に移行した場合、レイテンシーに変化はありますか?
**回答:** 実行するアクションによって は、レイテンシーが減少する場合があります。これは、CodeCatalyst サーバーが PDX リージョンでホストされているためです。
**質問:** インストール済みのソフトウェアはすべて引き継がれますか?
**回答:** いいえ、転送されるのはコードリソースだけです。バイナリ、設定、およびインストールされたソフトウェアは転送されません。
# Amazon CodeCatalyst の開発環境
以下のセクションでは、IDE を使用して CodeCatalyst AWS Cloud9 で開発環境を作成および管理する方法の概要を説明します。
+ [開発環境の作成](#ide-toolkits-create-cloud9)
+ [開発環境設定を開く](#ide-toolkits-settings-cloud9)
+ [開発環境の再開](#ide-toolkits-resume-cloud9)
+ [開発環境の削除](#ide-toolkits-delete-cloud9)
+ [開発環境のリポジトリ devfile の編集](#ide-toolkits-edit-devfile-cloud9)
+ [リポジトリの複製](#ide-toolkits-clone-cloud9)
+ [開発環境のトラブルシューティング](#cloud9-devenvironment-troubleshoot)
## 開発環境の作成
開発環境は複数の方法で作成できます。
+ CodeCatalyst で **[概要]**、**[開発環境]**、または **[ソースリポジトリ]** の各ページから CodeCatalyst ソースリポジトリを使用して開発環境を作成します。
+ 開発環境から CodeCatalyst のソースリポジトリに接続していない空の開発環境を作成します。
+ 任意の IDE で開発環境を作成し、この開発環境内に CodeCatalyst ソースリポジトリを複製します。
ブランチおよびリポジトリごとに 1 つの開発環境を作成できます。プロジェクトは複数のリポジトリを持つことができます。開発環境は CodeCatalyst アカウントにのみ関連付けられ、CodeCatalyst アカウントでのみ管理できます。開発環境を開いて、サポートされている IDE のいずれかを使用して操作できます。特定の IDE を選択すると、その IDE でのみ開発環境を開くことができます。別の IDE を使用する場合は、ナビゲーションバーで開発環境を選択し、[**編集**] を選択するか、新しい開発環境を作成することで IDE を変更できます。デフォルトでは、開発環境は 2 コアプロセッサ、4 GB の RAM、16 GB の永続ストレージで作成されます。
CodeCatalyst で開発環境を作成する方法の詳細については、『*Amazon CodeCatalyst ガイド*』の「[開発環境の作成](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-create.html)」を参照してください。
CodeCatalyst で開発環境を作成するための詳細と手順については、「Amazon CodeCatalyst ユーザーガイド」の「[開発環境の作成](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-create.html)」を参照してください。
**注記**
サードパーティのソースリポジトリを使用して開発環境を作成できるようになりました。サードパーティのソースリポジトリを CodeCatalyst 内のプロジェクトにリンクする方法については、「Amazon CodeCatalyst ユーザーガイド」の「[ソースリポジトリのリンク](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-repositories-link.html)」を参照してください。
**重要**
開発環境は、CodeCatalyst 認証情報にアクセスできる devfile を介してスクリプトを実行できます。信頼できないリソースを開く前に、リポジトリを確認してください。
## 開発環境設定を開く
CodeCatalyst コンソールで開発環境を作成すると、特定の開発環境設定を表示できます。
1. CodeCatalyst コンソールから、 AWS Cloud9 IDE を介して開発環境に移動します。
1. AWS Cloud9 サイドバーから **[aws-explorer]** を選択します。
1. **[デベロッパーツール]** ナビゲーションペインで、**[CodeCatalyst]** を展開し、**[設定を開く]** を選択して、**[開発環境設定]** ビューを開きます。
1. **[開発環境設定]** ビューで、以下のセクションに開発環境のオプションが表示されます。
+ **[エイリアス:]** 開発環境に割り当てられている **[エイリアス]** を表示および変更します。
+ **[ステータス:]** 現在の開発環境のステータス、割り当てられているプロジェクトを表示し、開発環境を停止します。
+ **[Devfile:]** 開発環境の Devfile の名前と場所を表示します。Devfile を開くには、**[エディタで開く]** を選択します。
+ **Compute Settings (コンピューティング設定):** 開発環境のサイズとデフォルトの**タイムアウトまでの長さ**を変更します。
**注記**
開発環境を作成した後に、開発環境に割り当てたストレージ容量を変更することはできません。
**注記**
ターミナルから Amazon CodeCatalyst AWS CLI を使用する場合は、*CodeCatalyst コマンドを実行する前に、必ず AWS\$1PROFILE=codecatalyst* を設定する必要があります。 CodeCatalyst
## 開発環境の再開
開発環境の `$HOME` ディレクトリのすべての内容は永続的に保存されます。必要に応じて開発環境での作業を停止し、後で開発環境での作業を再開できます。開発環境の作成時に **[タイムアウト]** フィールドで選択した時間を超えて開発環境のアイドル状態が続いたとします。この場合、セッションは自動的に停止します。
開発環境は CodeCatalyst からのみ再開できます。開発環境の再開の詳細については、『*Amazon CodeCatalyst ガイド*』の「[開発環境の再開](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-resume.html)」を参照してください。
**注記**
開発環境の再開には数分かかる場合があります。
## 開発環境の削除
開発環境に保存されているコンテンツを使い終わったら、そのコンテンツを削除できます。開発環境を削除する前に、必ずコードの変更をコミットして元のソースリポジトリにプッシュしてください。開発環境を削除すると、開発環境のコンピューティングとストレージの請求は停止されます。
開発環境は、CodeCatalyst の **[Dev Environments]** (開発環境) ページからのみ削除できます。開発環境の削除方法の詳細については、『*Amazon CodeCatalyst ガイド*』の「[開発環境の削除](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-delete.html)」を参照してください。
## 開発環境のリポジトリ devfile の編集
開発環境の設定を変更するには、devfile を編集します。devfiles を使用して、チーム全体で開発環境を標準化できます。devfile は、CodeCatalyst のソースリポジトリのルートから編集できます。または、サポートされている IDE で devfile を編集することもできます。サポートされている IDE で devfile を編集する場合は、ソースリポジトリに変更をコミットしてプッシュするか、プルリクエストを作成します。これにより、チームメンバーは devfile の編集内容を確認して承認できます。
**注記**
devfile にはパブリックコンテナイメージのみを含めることができます。
**注記**
依存関係がない場合、一部の AWS Cloud9 IDE 機能はカスタム では機能しない場合がありますdevfile。Linux x64 以外の一部のプラットフォームで動作させるには、追加の作業が必要になる場合があります。
**で開発環境devfileのリポジトリを編集するには AWS Cloud9**
1. CodeCatalyst コンソールから、 AWS Cloud9 IDE を介して開発環境に移動します。
1. AWS Cloud9 サイドバーから、**aws-explorer** を選択します。
1. **[デベロッパーツール]** ナビゲーションペインで、**[CodeCatalyst ツールキット]** メニューを選択します。
1. **[Open Devfile]** (devfile を開く) を選択します。
1. devfile を編集し、ファイルを保存します。
1. メニューサイドバーから Git 拡張機能である **[Source Control]** を選択します。
1. **[Message]** (メッセージ) テキストフィールドに、変更をステージングする前のメッセージを入力します。
1. コミットの準備をするには、**[Stage All Changes (\$1)]** (すべての変更をステージング (\$1)) アイコンを選択します。
1. Git コマンドを表示するには、リポジトリ名の横にある **[メニュー]** アイコンを選択します。
1. **[Commit]** (コミット) と **[Push]** (プッシュ) を選択します。
1. AWS Toolkit メニューから、**[開発環境の更新]** を選択します。
**[Commit]** (コミット) と **[Push]** (プッシュ) を選択します。更新した devfile が保存され、変更がコミットされてプッシュされます。
**注記**
カスタム devfile を使用して起動したい開発環境が機能しないとしましょう。これは、devfile に AWS Cloud9 との互換性がないことが原因と考えられます。トラブルシューティングを行うには、devfile を参照してください。問題が解決しない場合は、削除して新しいものを作成してみてください。
開発環境の devfile は、CodeCatalyst で編集することもできます。詳細については、Amazon CodeCatalyst ガイドの「[Configuring your Dev Environment](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-devfile.html)」 (開発環境の設定) を参照してください。
## リポジトリの複製
ソースリポジトリ内の複数のファイル、ブランチ、コミットを効果的に操作するために、ソースリポジトリをローカルコンピューターにクローンできます。その場合、Git クライアントまたは IDE を使用して変更を加えます。CodeCatalyst から、他のGitホストプロバイダーと同じ方法で、またコマンドラインを使用して、IDE AWS Cloud9 Git拡張機能を使用できます。サードパーティのリポジトリをクローンする方法については、「[Git リポジトリを初期化またはクローンする](https://docs.aws.amazon.com/cloud9/latest/user-guide/using-gitpanel.html)」を参照してください。
ソースリポジトリから開発環境を作成して CodeCatalyst でクローンする方法の詳細については、『*Amazon CodeCatalyst ガイド*』の「[ソースリポジトリの概念](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-concepts-clone.html)」を参照してください。
## 開発環境のトラブルシューティング
開発環境で問題が発生した場合は、Amazon CodeCatalyst ガイドの「[Troubleshooting problems with Dev Environments](https://docs.aws.amazon.com/codecatalyst/latest/userguide/troubleshooting-devenvironments.html)」 (開発環境の問題のトラブルシューティング) を参照してください。
**注記**
ターミナルから Amazon CodeCatalyst AWS CLI を使用する場合は、*CodeCatalyst コマンドを実行する前に、必ず AWS\$1PROFILE=codecatalyst* を設定する必要があります。 CodeCatalyst
開発環境で問題が発生した場合は、Amazon CodeCatalyst ガイドの「[Troubleshooting problems with Dev Environments](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironments-troubleshooting.html)」 (開発環境の問題のトラブルシューティング) を参照してください。
# IDE AWS CDK での AWS Cloud9 の使用
**AWS CDK サービス** を使用すると、[AWS Cloud Development Kit (AWS CDK)](https://aws.amazon.com/cdk/) アプリケーションまたは *アプリ* を操作できます。の詳細については、 AWS CDK [AWS Cloud Development Kit (AWS CDK) デベロッパーガイド](https://docs.aws.amazon.com/cdk/latest/guide/)を参照してください。
AWS CDK アプリケーションは、*[コンストラクト](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html)*と呼ばれる構成要素で構成されています。これらの構成要素には、 CloudFormation スタックとその中の AWS リソースの定義が含まれます。**AWS CDK Explorer** を使用すると、 AWS CDK *ツリービュー*で定義されている[スタック](https://docs.aws.amazon.com/cdk/latest/guide/stacks.html)と[リソース](https://docs.aws.amazon.com/cdk/latest/guide/resources.html)を確認できます。このビューには、 AWS Cloud9 エディタ内の開発者ツールペインからアクセスできます。
このセクションでは、 AWS Cloud9 エディタ**AWS CDK **で にアクセスして使用する方法について説明します。
# AWS CDK アプリケーションの使用
AWS Cloud9 統合開発環境 (IDE) で **AWS CDK Explorer** を使用して、 AWS CDK アプリケーションを視覚化して操作します。
## 前提条件
AWS CDK コマンドラインインターフェイスをインストールします。手順については、 デベロ*AWS Cloud Development Kit (AWS CDK) ッパーガイド*[の AWS 「CDK の開始方法](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html)」を参照してください。
**重要**
インストールする AWS CDK バージョンは 1.17.0 以降である必要があります。実行中のバージョンは、**`cdk --version`** コマンドを使用して確認できます。
## AWS CDK アプリケーションを視覚化する
IDE AWS CDK Explorer を使用すると、アプリケーションの CDK AWS Cloud9 コンストラクトに保存されている[スタック](https://docs.aws.amazon.com/cdk/latest/guide/stacks.html)と[リソース](https://docs.aws.amazon.com/cdk/latest/guide/resources.html)を管理できます。 AWS CDK Explorer は、 `tree.json` ファイルで定義されている情報を使用して、リソースをツリービューに表示します。このファイルは、**`cdk synth`** コマンドを実行したときに作成されます。デフォルトでは、`tree.json` ファイルはアプリケーションの `cdk.out` ディレクトリにあります。
Toolkit AWS CDK Explorer の使用を開始するには、CDK アプリケーションを作成します。
1. [AWS CDK デベロッパーガイド](https://docs.aws.amazon.com/cdk/v2/guide/getting_started.html)で、[Hello World のチュートリアル](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html#hello_world_tutorial)の最初のいくつかのステップを完了します。
**重要**
「**スタックのデプロイ**」ステップに達したら、操作を中止してこのガイドに戻ってください。
**注記**
チュートリアルで提供されているコマンド (**`mkdir`**、**`cdk init`** など) は、オペレーティングシステムのコマンドラインインターフェイス、または VS Code エディタ内の**ターミナル**ウィンドウで実行できます。
1. CDK チュートリアルの必要なステップを完了したら、IDE エディタで作成した CDK AWS Cloud9 コンテンツを開きます。
1. AWS ナビゲーションペインで、**CDK ** 見出しを展開します。CDK アプリケーションとその関連リソースが CDK Explorer のツリービューに表示されます。また、 AWS Cloud9 内のターミナルで次のコマンドを実行して、CDK 機能が有効であることを確認できます。
```
mkdir mycdkapp
cd mycdkapp
cdk init app --language=typescript
cdk synth
cdk bootstrap
```
### 重要な注意事項
+ CDK アプリケーションを AWS Cloud9 エディタにロードすると、複数のフォルダを一度にロードできます。各フォルダには、前のイメージに示すように、複数の CDK アプリを含めることができます。 AWS CDK Explorer は、プロジェクトのルートディレクトリとその直接サブディレクトリでアプリケーションを検索します。
+ チュートリアルの最初のいくつかのステップを実行すると、最後に実行したコマンドが **`cdk synth`** であることに気付く場合があります。このコマンドは、 AWS CDK アプリケーションを CFN に変換することで CloudFormation テンプレートを合成します。また、副産物として `tree.json` ファイルを生成します。CDK アプリケーションに変更を加えた場合は、**`cdk synth`** コマンドを再度実行して、変更がツリービューに反映されていることを確認します。変更の 1 つの例として、アプリケーションへのリソースの追加があります。
## AWS CDK アプリケーションで他のオペレーションを実行する
AWS Cloud9 エディタを使用して、コマンドラインインターフェイスを使用するのと同じ方法で CDK アプリケーションで他のオペレーションを実行できます。たとえば、エディタでコードファイルを更新し、 AWS Cloud9 **ターミナル**ウィンドウを使用してアプリケーションをデプロイできます。
これらのタイプのアクションを試すには、 AWS Cloud9 エディタを使用して、 *AWS CDK デベロッパーガイド*の [Hello World チュートリアル](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html#hello_world_tutorial)を続行します。最後のステップである「**アプリケーションのリソースの破棄**」を必ず実行してください。実行しないと、 AWS アカウントで予想外のコストがかかる可能性があります。