チュートリアル: 空のプロジェクトから開始し、リソースを手動で追加する

プロジェクトの作成時に空のプロジェクトブループリントを選択すると、その中に事前定義されたリソースなしで空のプロジェクトを作成できます。空のプロジェクトを作成したら、プロジェクトのニーズに応じてリソースを作成して追加できます。ブループリントなしで作成されたプロジェクトは作成時に空になるため、このオプションでは、開始するための CodeCatalyst リソースの作成と設定に関するより多くの知識が必要です。

前提条件

空のプロジェクトを作成するには、スペース管理者またはパワーユーザーロールを割り当てる必要があります。に初めてサインインする場合は CodeCatalyst、「」を参照してくださいのセットアップと へのサインイン CodeCatalyst。

空のプロジェクトを作成する

プロジェクトの作成は、連携するための最初のステップです。ソースリポジトリやワークフローなどの独自のリソースを作成する場合は、空のプロジェクトから開始できます。

空のプロジェクトを作成するには

1. プロジェクトを作成するスペースに移動します。

2. スペースダッシュボードで、[プロジェクトの作成] を選択します。

3. [最初から開始] を選択します。

4. [プロジェクトに名前を付ける] に、プロジェクトに割り当てる名前を入力します。名前はスペース内で一意でなければなりません。

5. [プロジェクトを作成] を選択します。

プロジェクトが空になったので、次のステップはソースリポジトリを作成することです。

ソースリポジトリを作成する

ソースリポジトリを作成して、プロジェクトのコードを保存して共同作業します。プロジェクトメンバーは、このリポジトリをローカルコンピュータにクローンしてコードを操作することができます。または、サポートされているサービスでホストされているリポジトリをリンクすることもできますが、このチュートリアルでは説明していません。詳細については、「ソースリポジトリのリンク」を参照してください。

ソースリポジトリを作成するには

1. https://codecatalyst.aws/ で CodeCatalyst コンソールを開きます。

2. プロジェクトに移動します。

3. ナビゲーションペインで [コード] を選択してから、[ソースリポジトリ] を選択します。

4. [リポジトリの追加] を選択し、[リポジトリの作成] を選択します。

5. [リポジトリ名] で、リポジトリの名前を指定します。このガイドでは を使用していますがcodecatalyst-source-repository、別の名前を選択できます。リポジトリ名は、プロジェクト内で一意である必要があります。リポジトリ名の要件の詳細については、「」を参照してくださいのソースリポジトリのクォータ CodeCatalyst。

6. （オプション) 説明 で、プロジェクト内の他のユーザーがリポジトリが何に使用されるかを理解するのに役立つリポジトリの説明を追加します。

7. リポジトリの作成 (デフォルト） を選択します。このオプションは、デフォルトのブランチと README.md ファイルを含むリポジトリを作成します。空のリポジトリとは異なり、このリポジトリは作成後すぐに使用できます。

8. デフォルトのブランチ では、別の名前を選択する理由がない限り、名前をメインのままにします。このガイドのすべての例では、デフォルトのブランチに main という名前を使用しています。

9. （オプション) プッシュする予定のコードタイプの.gitignoreファイルを追加します。

10. [作成] を選択します。

    注記

    CodeCatalyst は、作成時にリポジトリにREADME.mdファイルを追加します。 CodeCatalyst は、main という名前のデフォルトブランチにリポジトリの初期コミットも作成します。README.md ファイルを編集または削除することはできますが、デフォルトのブランチを削除することはできません。

開発環境を作成することで、リポジトリにコードをすばやく追加できます。このチュートリアルでは、 を使用して開発環境を作成し AWS Cloud9、開発環境を作成するときにメインブランチからブランチを作成するオプションを選択することをお勧めします。test このブランチには名前を使用しますが、必要に応じて別のブランチ名を入力できます。

新しいブランチを使用して開発環境を作成するには

1. https://codecatalyst.aws/ で CodeCatalyst コンソールを開きます。

2. 開発環境を作成するプロジェクトに移動します。

3. プロジェクトのソースリポジトリのリストからリポジトリの名前を選択します。または、ナビゲーションペインでコード を選択し、ソースリポジトリ を選択し、開発環境を作成するリポジトリを選択します。

4. リポジトリのホームページで、開発環境の作成 を選択します。

5. サポートされている IDE をドロップダウンメニューから選択します。詳細については、「開発環境でサポートされている統合開発環境」を参照してください。

6. クローンするリポジトリを選択し、[新しいブランチで作業する] を選択し、[ブランチ名] フィールドにブランチ名を入力し、[ブランチの作成元] ドロップダウンメニューから新しいブランチを作成するブランチを選択します。

7. オプションで、開発環境のエイリアスを追加します。

8. オプションで、[開発環境設定] 編集ボタンを選択して、開発環境のコンピューティング、ストレージ、またはタイムアウト設定を編集します。

9. [作成] を選択します。開発環境の作成中は、開発環境のステータス列に [開始中] と表示され、開発環境が作成されると、ステータス列に [実行中] と表示されます。新しいタブが開き、選択した IDE で開発環境が表示されます。コードを編集し、変更をコミットしてプッシュできます。

コード変更を構築、テスト、デプロイするワークフローを作成する

では CodeCatalyst、ワークフローでのアプリケーションまたはサービスの構築、テスト、デプロイを整理します。ワークフローは アクションで構成され、コードのプッシュ、プルリクエストのオープンや更新など、指定されたソースリポジトリイベントが発生した後に自動的に実行されるように設定できます。ワークフローの詳細については、「でワークフローを使用して構築、テスト、デプロイする CodeCatalyst」を参照してください。

の手順に従ってワークフローの開始方法、最初のワークフローを作成します。

プロジェクトに誰かを招待する

カスタムプロジェクトをセットアップしたので、他のユーザーを招待して協力してもらいます。

プロジェクトに誰かを招待するには

1. ユーザーを招待するプロジェクトに移動します。

2. ナビゲーションペインで、プロジェクト設定 を選択します。

3. メンバー タブで、招待 を選択します。

4. プロジェクトのユーザーとして招待するユーザーの E メールアドレスを入力します。複数の E メールアドレスをスペースまたはカンマで区切って入力できます。プロジェクトのメンバーではないスペースのメンバーから選択することもできます。

5. ユーザーのロールを選択します。

   ユーザーの追加が完了したら、招待 を選択します。

作業の共同作業と追跡に関する問題を作成する

CodeCatalyst は、問題のあるプロジェクトに関連する機能、タスク、バグ、その他の作業を追跡するのに役立ちます。問題を作成して、必要な作業やアイデアを追跡できます。デフォルトでは、問題を作成すると、バックログに追加されます。進行中の作業を追跡するボードに問題を移動できます。特定のプロジェクトメンバーに問題を割り当てることもできます。

プロジェクトの問題を作成するには

1. https://codecatalyst.aws/ で CodeCatalyst コンソールを開きます。

   問題を作成するプロジェクトをナビゲートしていることを確認してください。すべてのプロジェクトを表示するには、ナビゲーションペインで Amazon CodeCatalystを選択し、必要に応じてすべてのプロジェクトを表示 を選択します。問題を作成または処理するプロジェクトを選択します。

2. ナビゲーションペインで、追跡 を選択し、バックログ を選択します。

3. 問題の作成 を選択します。

4. 問題タイトル で、問題の名前を指定します。必要に応じて、問題の説明を入力します。必要に応じて、問題のステータス、優先度、見積りを選択します。プロジェクトメンバーのリストからプロジェクトメンバーに問題を割り当てることもできます。

   ヒント

   Amazon Q に問題を割り当てることで、Amazon Q で問題の解決を試みることができます。試行が成功すると、プルリクエストが作成され、問題のステータスが「レビュー中」に変わり、コードを確認してテストできるようになります。詳細については、「チュートリアル: CodeCatalyst 生成 AI 機能を使用して開発作業を高速化する」を参照してください。

   この機能を使用するには、空間に対して生成 AI 機能を有効にする必要があります。詳細については、「生成 AI 機能の管理」を参照してください。

5. [保存] を選択します。

問題を作成したら、プロジェクトメンバーに割り当てて見積もり、Kanban ボードで追跡できます。詳細については、「で問題のある作業を追跡して整理する CodeCatalyst」を参照してください。