プロジェクトの作成時に [空のプロジェクト] ブループリントを選択すると、その中に事前定義されたリソースなしで空のプロジェクトを作成できます。空のプロジェクトを作成したら、プロジェクトのニーズに応じてリソースを作成して追加できます。ブループリントなしで作成したプロジェクトは作成時に空になるため、このオプションでは、CodeCatalyst リソースの作成と設定に関するより多くの知識が必要です。
トピック
前提条件
空のプロジェクトを作成するには、[スペース管理者] または [パワーユーザー] ロールを割り当てる必要があります。CodeCatalyst に初めてサインインする場合は、「CodeCatalyst をセットアップしてサインインする」を参照してください。
空のプロジェクトを作成する
プロジェクトの作成は、連携するための最初のステップです。ソースリポジトリやワークフローなどの独自のリソースを作成する場合は、空のプロジェクトから開始できます。
空のプロジェクトを作成するには
-
プロジェクトを作成するスペースに移動します。
-
スペースダッシュボードで、[プロジェクトの作成] を選択します。
-
[最初から開始] を選択します。
-
[プロジェクトに名前を付ける] に、プロジェクトに割り当てる名前を入力します。名前はスペース内で一意でなければなりません。
-
[プロジェクトを作成] を選択します。
空のプロジェクトができたので、次のステップはソースリポジトリを作成することです。
ソースリポジトリを作成する
ソースリポジトリを作成して、プロジェクトのコードを保存してコラボレーションします。プロジェクトメンバーは、このリポジトリをローカルコンピュータにクローンして、コードを操作できます。または、サポートされているサービスでホストされているリポジトリをリンクすることもできますが、このチュートリアルでは説明していません。詳細については、「ソースリポジトリをリンクする」を参照してください。
ソースリポジトリを作成するには
https://codecatalyst.aws/
で CodeCatalyst コンソールを開きます。 -
プロジェクトに移動します。
-
ナビゲーションペインで [コード] を選択してから、[ソースリポジトリ] を選択します。
-
[リポジトリの追加] を選択し、[リポジトリの作成] を選択します。
-
[リポジトリ名] で、リポジトリの名前を指定します。このガイドでは、
[codecatalyst-source-repository]
を使用しますが、別の名前を選択できます。リポジトリ名は、プロジェクト内で一意である必要があります。リポジトリ名の要件の詳細については、「CodeCatalyst のソースリポジトリのクォータ」を参照してください。 -
(オプション) [説明] に、プロジェクト内の他のユーザーがリポジトリの用途を理解しやすいように、リポジトリの説明を追加します。
-
[リポジトリを作成 (デフォルト)] を選択します。このオプションは、デフォルトのブランチと README.md ファイルを含むリポジトリを作成します。空のリポジトリとは異なり、このリポジトリは作成後すぐに使用できます。
-
[デフォルトのブランチ] では、別の名前を選択する理由がない限り、名前を [メイン] のままにします。このガイドのすべての例では、デフォルトブランチに main という名前を使用しています。
-
(オプション) プッシュする予定のコードの種類に応じた
.gitignore
ファイルを追加します。 -
[Create] (作成) を選択します。
注記
CodeCatalyst は、ユーザーがリポジトリを作成するときに、
README.md
ファイルをリポジトリに追加します。また、CodeCatalyst は main という名前のデフォルトブランチにリポジトリの初期コミットを作成します。README.md ファイルは編集または削除できますが、デフォルトブランチを削除することはできません。
開発環境を作成することで、リポジトリにコードをすばやく追加できます。このチュートリアルでは、AWS Cloud9 を使用して開発環境を作成し、開発環境を作成するときに [メイン] ブランチからブランチを作成するオプションを選択します。このブランチには「test
」の名前を使用しますが、必要に応じて別のブランチ名を入力できます。
新しいブランチで開発環境を作成するには
https://codecatalyst.aws/
で CodeCatalyst コンソールを開きます。 開発環境を作成するプロジェクトに移動します。
プロジェクトのソースリポジトリのリストからリポジトリ名を選択します。または、ナビゲーションペインで [コード] を選択し、[ソースリポジトリ] を選択し、開発環境を作成するリポジトリを選択します。
リポジトリのホームページで、[開発環境を作成] を選択します。
ドロップダウンメニューからサポートされている IDE を選択します。詳細については、「開発環境でサポートされている統合開発環境」を参照してください。
クローンするリポジトリを選択し、[新しいブランチで作業する] を選択し、[ブランチ名] フィールドにブランチ名を入力し、[ブランチの作成元] ドロップダウンメニューから新しいブランチを作成するブランチを選択します。
オプションで、開発環境のエイリアスを追加します。
オプションで、[開発環境設定] 編集ボタンを選択して、開発環境のコンピューティング、ストレージ、またはタイムアウト設定を編集します。
[Create] (作成) を選択します。開発環境の作成中は、開発環境のステータス列に [開始中] と表示され、開発環境が作成されると、ステータス列に [実行中] と表示されます。新しいタブが開き、選択した IDE で開発環境が表示されます。コードを編集し、変更をコミットしてプッシュできます。
コード変更をビルド、テスト、デプロイするワークフローを作成する
CodeCatalyst では、アプリケーションまたはサービスのビルド、テスト、デプロイをワークフローに整理します。ワークフローはアクションで構成され、コードプッシュ、プルリクエストのオープンや更新など、指定されたソースリポジトリイベントが発生した後に自動的に実行されるように設定できます。ワークフローの詳細については、「ワークフローを使用して構築、テスト、デプロイする」を参照してください。
初めてのワークフロー の手順に従って、最初のワークフローを作成します。
プロジェクトに誰かを招待する
カスタムプロジェクトをセットアップしたら、他のユーザーを招待して作業を依頼します。
誰かをプロジェクトに招待するには
-
ユーザーを招待するプロジェクトに移動します。
-
ナビゲーションペインで、[プロジェクト設定] を選択します。
-
[メンバー] タブで、[招待] を選択します。
-
プロジェクトのユーザーとして招待するユーザーの E メールアドレスを入力します。スペースまたはカンマで区切って複数の E メールアドレスを入力できます。また、プロジェクトのメンバーではないスペースのメンバーから選択することもできます。
ユーザーのロールを選択します。
ユーザーの追加が完了したら、[招待] を選択します。
作業を共同作業して追跡するための問題を作成する
CodeCatalyst は、問題のあるプロジェクトに関連する機能、タスク、バグ、その他の作業を追跡するのに役立ちます。必要な作業やアイデアを追跡するための問題を作成できます。デフォルトでは、問題を作成するとバックログに追加されます。進行中の作業を追跡するボードに問題を移動できます。特定のプロジェクトメンバーに問題を割り当てることもできます。
プロジェクトの問題を作成するには
-
https://codecatalyst.aws/
で CodeCatalyst コンソールを開きます。 問題を作成するプロジェクトをナビゲートしていることを確認してください。すべてのプロジェクトを表示するには、ナビゲーションペインで [Amazon CodeCatalyst] を選択し、必要に応じて [すべてのプロジェクトを表示] を選択します。問題を作成または処理するプロジェクトを選択します。
-
ナビゲーションペインで、[トラック] を選択し、次に [バックログ] を選択します。
-
[問題の作成] を選択します。
-
[問題タイトル]で、問題の名前を指定します。必要に応じて、問題の説明を入力します。必要に応じて、問題のステータス、優先度、見積りを選択します。プロジェクトメンバーの一覧からプロジェクトメンバーに問題を割り当てることもできます。
ヒント
[Amazon Q] に問題を割り当てることで、Amazon Q で問題の解決を試みることができます。試行が成功すると、プルリクエストが作成され、問題のステータスが [レビュー中] に変わり、コードを確認してテストできるようになります。詳細については、「チュートリアル: CodeCatalyst の生成 AI 機能を使用して開発作業を高速化する」を参照してください。
この機能を使用するには、スペースに対して生成 AI 機能を有効にする必要があります。詳細については、「Managing generative AI features」を参照してください。
-
[Save] を選択します。
問題を作成したら、プロジェクトメンバーに割り当て、見積もり、Kanban ボードでトラッキングできます。詳細については、「CodeCatalyst で問題を使用して作業の追跡と整理を行う」を参照してください。