Amazon CodeCatalyst の開発環境 - AWS Cloud9

AWS Cloud9 は、新規顧客には利用できなくなりました。 AWS Cloud9 の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon CodeCatalyst の開発環境

以下のセクションでは、AWS Cloud9 IDE を使用して CodeCatalyst で開発環境を作成および管理する方法について説明します。

開発環境の作成

開発環境は複数の方法で作成できます。

  • CodeCatalyst で [概要][開発環境]、または [ソースリポジトリ] の各ページから CodeCatalyst ソースリポジトリを使用して開発環境を作成します。

  • 開発環境から CodeCatalyst のソースリポジトリに接続していない空の開発環境を作成します。

  • 任意の IDE で開発環境を作成し、この開発環境内に CodeCatalyst ソースリポジトリを複製します。

ブランチおよびリポジトリごとに 1 つの開発環境を作成できます。プロジェクトは複数のリポジトリを持つことができます。開発環境は CodeCatalyst アカウントにのみ関連付けられ、CodeCatalyst アカウントでのみ管理できます。開発環境を開いて、サポートされている IDE のいずれかを使用して操作できます。特定の IDE を選択すると、その IDE でのみ開発環境を開くことができます。別の IDE を使用する場合は、ナビゲーションバーで開発環境を選択し、[編集] を選択するか、新しい開発環境を作成することで IDE を変更できます。デフォルトでは、開発環境は 2 コアプロセッサ、4 GB の RAM、16 GB の永続ストレージで作成されます。

CodeCatalyst で開発環境を作成する方法の詳細については、『Amazon CodeCatalyst ガイド』の「開発環境の作成」を参照してください。

CodeCatalyst で開発環境を作成するための詳細と手順については、「Amazon CodeCatalyst ユーザーガイド」の「開発環境の作成」を参照してください。

注記

サードパーティのソースリポジトリを使用して開発環境を作成できるようになりました。サードパーティのソースリポジトリを CodeCatalyst 内のプロジェクトにリンクする方法については、「Amazon CodeCatalyst ユーザーガイド」の「ソースリポジトリのリンク」を参照してください。

開発環境設定を開く

CodeCatalyst コンソールで開発環境を作成すると、特定の開発環境設定を表示できます。

  1. CodeCatalyst コンソールから、AWS Cloud9 IDE を介して開発環境に移動します。

  2. AWS Cloud9 サイドバーから [aws-explorer] を選択します。

  3. [デベロッパーツール] ナビゲーションペインで、[CodeCatalyst] を展開し、[設定を開く] を選択して、[開発環境設定] ビューを開きます。

  4. [開発環境設定] ビューで、以下のセクションに開発環境のオプションが表示されます。

    • [エイリアス:] 開発環境に割り当てられている [エイリアス] を表示および変更します。

    • [ステータス:] 現在の開発環境のステータス、割り当てられているプロジェクトを表示し、開発環境を停止します。

    • [Devfile:] 開発環境の Devfile の名前と場所を表示します。Devfile を開くには、[エディタで開く] を選択します。

    • Compute Settings (コンピューティング設定): 開発環境のサイズとデフォルトのタイムアウトまでの長さを変更します。

注記

開発環境を作成した後に、開発環境に割り当てたストレージ容量を変更することはできません。

注記

ターミナルから Amazon CodeCatalyst AWS CLI を使用するときは、CodeCatalyst コマンドを実行する前に、必ず AWS_PROFILE=codecatalyst を設定します。

開発環境の再開

開発環境の $HOME ディレクトリのすべての内容は永続的に保存されます。必要に応じて開発環境での作業を停止し、後で開発環境での作業を再開できます。開発環境の作成時に [タイムアウト] フィールドで選択した時間を超えて開発環境のアイドル状態が続いたとします。この場合、セッションは自動的に停止します。

開発環境は CodeCatalyst からのみ再開できます。開発環境の再開の詳細については、『Amazon CodeCatalyst ガイド』の「開発環境の再開」を参照してください。

注記

開発環境の再開には数分かかる場合があります。

開発環境の削除

開発環境に保存されているコンテンツを使い終わったら、そのコンテンツを削除できます。開発環境を削除する前に、必ずコードの変更をコミットして元のソースリポジトリにプッシュしてください。開発環境を削除すると、開発環境のコンピューティングとストレージの請求は停止されます。

開発環境は、CodeCatalyst の [Dev Environments] (開発環境) ページからのみ削除できます。開発環境の削除方法の詳細については、『Amazon CodeCatalyst ガイド』の「開発環境の削除」を参照してください。

開発環境のリポジトリ devfile の編集

開発環境の設定を変更するには、devfile を編集します。devfiles を使用して、チーム全体で開発環境を標準化できます。devfile は、CodeCatalyst のソースリポジトリのルートから編集できます。または、サポートされている IDE で devfile を編集することもできます。サポートされている IDE で devfile を編集する場合は、ソースリポジトリに変更をコミットしてプッシュするか、プルリクエストを作成します。これにより、チームメンバーは devfile の編集内容を確認して承認できます。

注記

devfile にはパブリックコンテナイメージのみを含めることができます。

注記

依存関係がない場合、AWS Cloud9 IDE の一部の機能は、カスタム devfile では動作しないことがあります。Linux x64 以外の一部のプラットフォームで動作させるには、追加の作業が必要になる場合があります。

AWS Cloud9 で開発環境のリポジトリ devfile を編集するには
  1. CodeCatalyst コンソールから、AWS Cloud9 IDE を介して開発環境に移動します。

  2. AWS Cloud9 サイドバーから [aws-explorer] を選択します。

  3. [デベロッパーツール] ナビゲーションペインで、[CodeCatalyst ツールキット] メニューを選択します。

  4. [Open Devfile] (devfile を開く) を選択します。

  5. devfile を編集し、ファイルを保存します。

  6. メニューサイドバーから Git 拡張機能である [Source Control] を選択します。

  7. [Message] (メッセージ) テキストフィールドに、変更をステージングする前のメッセージを入力します。

  8. コミットの準備をするには、[Stage All Changes (+)] (すべての変更をステージング (+)) アイコンを選択します。

  9. Git コマンドを表示するには、リポジトリ名の横にある [メニュー] アイコンを選択します。

  10. [Commit] (コミット) と [Push] (プッシュ) を選択します。

  11. AWS Toolkit メニューから、[開発環境の更新] を選択します。

    [Commit] (コミット) と [Push] (プッシュ) を選択します。更新した devfile が保存され、変更がコミットされてプッシュされます。

注記

カスタム devfile を使用して起動したい開発環境が機能しないとしましょう。これは、devfile に AWS Cloud9 との互換性がないことが原因と考えられます。トラブルシューティングを行うには、devfile を参照してください。問題が解決しない場合は、削除して新しいものを作成してみてください。

開発環境の devfile は、CodeCatalyst で編集することもできます。詳細については、Amazon CodeCatalyst ガイドの「Configuring your Dev Environment」 (開発環境の設定) を参照してください。

リポジトリの複製

ソースリポジトリ内の複数のファイル、ブランチ、コミットを効果的に操作するために、ソースリポジトリをローカルコンピューターにクローンできます。その場合、Git クライアントまたは IDE を使用して変更を加えます。CodeCatalyst から、他の Git ホストプロバイダーと同じ方法で、またコマンドラインを使用して、AWS Cloud9 IDE Git 拡張機能を使用できます。サードパーティのリポジトリをクローンする方法については、「Git リポジトリを初期化またはクローンする」を参照してください。

ソースリポジトリから開発環境を作成して CodeCatalyst でクローンする方法の詳細については、『Amazon CodeCatalyst ガイド』の「ソースリポジトリの概念」を参照してください。

開発環境のトラブルシューティング

開発環境で問題が発生した場合は、Amazon CodeCatalyst ガイドの「Troubleshooting problems with Dev Environments」 (開発環境の問題のトラブルシューティング) を参照してください。

注記

ターミナルから Amazon CodeCatalyst AWS CLI を使用するときは、CodeCatalyst コマンドを実行する前に、必ず AWS_PROFILE=codecatalyst を設定します。

開発環境で問題が発生した場合は、Amazon CodeCatalyst ガイドの「Troubleshooting problems with Dev Environments」 (開発環境の問題のトラブルシューティング) を参照してください。