Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CodeCatalyst のプロジェクトの作業を整理する
Amazon CodeCatalyst のプロジェクトを使用して、開発チームが継続的インテグレーション/継続的デリバリー (CI/CD) ワークフローとリポジトリを共有し、開発タスクを実行できる、コラボレーションスペースを確立します。プロジェクトの作成時には、リソースを追加、更新、または削除できます。チームの作業の進行状況をモニタリングすることもできます。1 つのスペースに複数のプロジェクトを含めることができます。
CodeCatalyst のスペースは、プロジェクトで構成されます。スペース内のすべてのプロジェクトを表示できますが、使用できるのは、自分がメンバーであるプロジェクトのみです。プロジェクトの作成時には、プロジェクトのデフォルトのロールが生成されます。ロールはプロジェクトに招待するユーザーに割り当てることができます。
+ プロジェクトに割り当てられ、プロジェクトロール (例えば **投稿者ロール**など) を持つユーザーは、プロジェクトリソース (ソースリポジトリなど) にアクセスできます。
+ **スペース管理者**または**プロジェクト管理者**ロールを持つユーザーは、プロジェクトに参加するための招待を送信できます。
+ **プロジェクト管理者**ロールを持つユーザーは、共有リソース全体のアクティビティ、ステータス、その他の設定を追跡できます。
+ **制限付きアクセス**ロールを持つユーザーは、CI/CD ワークフローの一部として、機能、コード修正、テストのプロジェクト割り当てを管理できます。
ワークフローは、CI/CD パイプラインとしてアプリケーションをビルド、テスト、リリース、更新するために使用されます。ワークフローを組み立てるには、ソースアーティファクトを転送して操作するアクションを追加します。アクションを実行すると、プロジェクトクラウドリソースが使用され、ワークフローアクションのためのオンデマンドコンピューティング機能が提供されます。設定するアクティビティと出力に基づいて、さらに CI/CD ワークフローを設定できます。例えば、ビルドとテストのアクションのみのワークフローを作成して、デプロイなしでテスト結果を表示してワークフローを完了し、バグの修正を行うことができます。次に、別のワークフローを作成し、アプリケーションをビルドしてステージング環境にデプロイできます。
プロジェクトの作成時には、ブループリントを使用して、サンプルコードを含み、リソースを作成するプロジェクトを作成するか、または空のプロジェクトから開始できます。ブループリントを使用してプロジェクトを作成すると、選択したブループリントによって、プロジェクトに追加されるリソースと、CodeCatalyst が作成または設定するツールが決まり、プロジェクトリソースを追跡して使用できます。プロジェクトを作成したら、リソースを手動で追加または削除できます。
各プロジェクトは、ユーザーによるイベント (プロジェクトの作成時、リソースの変更時など) のリストとして、プロジェクトアクティビティを追跡します 。プロジェクトアクティビティは、スペースレベルでモニタリングおよび集計されます。アクティビティデータの操作の詳細については、「[スペース内のすべてのプロジェクトを表示する](projects-view-overview.md)」を参照してください。
プロジェクトでリソースを使用している場合は AWS 、CodeCatalyst アカウントを、 AWS プロジェクトのリソースを統合するための管理アクセス許可を持つアカウントに接続できます。
プロジェクトを作成したら、ソースリポジトリ、問題、その他のリソースを追加できます。プロジェクトを作成するには、**スペース管理者**ロールが必要です。
# プロジェクトの作成
CodeCatalyst プロジェクトを使用すると、継続的インテグレーションと継続的デリバリー (CI/CD) の共有ワークフローとリポジトリを使用して、開発タスクの実行、リソースの管理、問題の追跡、ユーザーの追加を実行できます。
プロジェクトを作成する前に、**スペース管理者**または**パワーユーザー**ロールが必要です。
**Topics**
+ [Amazon CodeCatalyst での空のプロジェクトの作成](#projects-create-empty)
+ [リンクされたサードパーティーリポジトリを使用したプロジェクトの作成](#projects-create-3p-repo)
+ [ブループリントを使用したプロジェクトの作成](#projects-create-console-template)
+ [Amazon Q を使用したプロジェクトの作成やブループリントの機能追加のベストプラクティス](#projects-create-amazon-q)
+ [プロジェクトでブループリントを使用するためのベストプラクティス](#projects-create-use-blueprints)
+ [作成したプロジェクトへのリソースとタスクの追加](#projects-create-after-steps)
## Amazon CodeCatalyst での空のプロジェクトの作成
リソースなしで空のプロジェクトを作成し、後で必要なリソースを手動で追加できます。
プロジェクトを作成する前に、**スペース管理者**または**パワーユーザー**ロールが必要です。
**空のプロジェクトを作成するには**
1. プロジェクトを作成するスペースに移動します。
1. スペースダッシュボードで、**[プロジェクトの作成]** を選択します。
1. **[最初から開始]** を選択します。
1. **[プロジェクトに名前を付ける]** に、プロジェクトに割り当てる名前を入力します。名前はスペース内で一意でなければなりません。
1. **[プロジェクトを作成]** を選択します。
## リンクされたサードパーティーリポジトリを使用したプロジェクトの作成
プロジェクトのソースコードを希望するサードパーティープロバイダーに保持しながら、CodeCatalyst のすべての機能 (ブループリント、ライフサイクル管理、ワークフローなど) を使用できます。これを行うには、GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリにリンクする、新しい CodeCatalyst プロジェクトを作成できます。その後、CodeCatalyst プロジェクトでリンクされたソースリポジトリを使用できます。
CodeCatalyst プロジェクトを作成する前に、**スペース管理者**または**パワーユーザー**ロールが必要です。詳細については、「[スペースを作成する](spaces-create.md)」および「[スペースへのユーザーの直接招待](spaces-members-add-admin.md)」を参照してください。
GitHub アカウントのソースリポジトリにリンクするプロジェクトを CodeCatalyst で作成するには、次の 3 つのタスクを完了する必要があります。
1. **GitHub リポジトリ**、**Bitbucket リポジトリ**、または **GitLab リポジトリ**拡張機能をインストールします。外部サイトでは、リポジトリに接続して CodeCatalyst にアクセス権を付与するように求められます。これは次のステップの一環として行われます。
**重要**
**GitHub リポジトリ**、**Bitbucket リポジトリ**、または **GitLab リポジトリ**拡張機能を CodeCatalyst スペースにインストールするには、スペースに**スペース管理者**ロールを持つアカウントでサインインする必要があります。
1. GitHub アカウントまたは Bitbucket ワークスペース、または GitLab ユーザーを CodeCatalyst に接続します。
**重要**
GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザーを CodeCatalyst スペースに接続するには、サードパーティーソースの管理者と CodeCatalyst **スペース管理者**の両方である必要があります。
**重要**
リポジトリ拡張機能をインストールすると、CodeCatalyst にリンクするすべてのリポジトリのコードがインデックス化され、CodeCatalyst に保存されます。これにより、コードが CodeCatalyst で検索できるようになります。CodeCatalyst でリンクされたリポジトリを使用する際のコードのデータ保護の詳細については、「*Amazon CodeCatalyst ユーザーガイド*」の「[データ保護](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)」を参照してください。
1. GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリにリンクされた CodeCatalyst プロジェクトを作成します。
**重要**
**寄稿者**は、GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリをリンクすることはできますが、サードパーティーリポジトリのリンクを解除できるのは**スペース管理者**または**プロジェクト管理者**のみです。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
**重要**
CodeCatalyst は、リンクされたリポジトリのデフォルトブランチの変更の検出をサポートしていません。リンクされたリポジトリのデフォルトブランチを変更するには、まず CodeCatalyst からリンクを解除し、デフォルトブランチを変更してから再度リンクする必要があります。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク](extensions-link.md)」を参照してください。
ベストプラクティスとして、リポジトリをリンクする前に、必ず最新バージョンの拡張機能があることを確認してください。
**注記**
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリは、スペース内の 1 つの CodeCatalyst プロジェクトにのみリンクできます。
CodeCatalyst プロジェクトでは、空の GitHub リポジトリまたはアーカイブされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用することはできません。
CodeCatalyst プロジェクトのリポジトリと同じ名前の GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリをリンクすることはできません。
**[GitHub リポジトリ]** 拡張機能は GitHub Enterprise Server リポジトリと互換性がありません。
**[Bitbucket リポジトリ]** 拡張機能は Bitbucket データセンターリポジトリと互換性がありません。
**[GitLab リポジトリ]** 拡張機能は GitLab セルフマネージドプロジェクトリポジトリと互換性がありません。
リンクされたリポジトリでは、**説明を記述する**機能や**コメントを要約する**機能は使用できません。これらの機能は、CodeCatalyst のプルリクエストでのみ使用できます。
詳細については、「[CodeCatalyst で拡張機能を持つプロジェクトに機能を追加する拡張機能を使用してプロジェクトに機能を追加する](extensions.md)」を参照してください。
**サードパーティー拡張機能をインストールするには**
1. プロジェクトを作成するスペースに移動します。
1. スペースダッシュボードで、**[プロジェクトの作成]** を選択します。
1. **[独自のコードを使用する]** を選択します。
1. **[既存のリポジトリのリンク]** で、使用するサードパーティーリポジトリプロバイダーに応じて、**[GitHub リポジトリ]**、**[Bitbucket リポジトリ]**、**[GitLab リポジトリ]** を選択します。以前に接続していない場合は、GitHub アカウント、Bitbucket ワークスペース、または GitLab アカウントを接続するように求められます。選択したサードパーティー拡張機能がまだインストールされていない場合は、インストールプロンプトが表示されます。
1. プロンプトが表示されたら、**[インストール]** を選択します。拡張機能に必要なアクセス許可を確認し、続行する場合は、**[インストール]** を再度選択します。
サードパーティーの拡張機能をインストールしたら、次のステップでは、GitHub アカウント、Bitbucket ワークスペース、または GitLab ユーザーを CodeCatalyst スペースに接続します。
**GitHub アカウント、Bitbucket ワークスペース、または GitLab ユーザーを CodeCatalyst に接続するには**
設定するサードパーティー拡張機能に応じて、次のいずれかを実行します。
+ **GitHub リポジトリ**: GitHub アカウントに接続します。
1. **[GitHub アカウントの接続]** を選択して、GitHub の外部サイトに移動します。
1. GitHub 認証情報を使用して GitHub アカウントにサインインし、Amazon CodeCatalyst をインストールするアカウントを選択します。
**ヒント**
以前に GitHub アカウントをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。複数の GitHub スペースのメンバーまたは共同作業者である場合は、拡張機能をインストールする場所を尋ねるダイアログボックスが表示されます。1 つの GitHub スペースのみに属している場合は、Amazon CodeCatalyst アプリケーションの設定ページが表示されます。リポジトリへのアクセスを許可するアプリケーションを設定し、**[保存]** を選択します。**[保存]** ボタンがアクティブでない場合は、設定を変更してから再試行してください。
1. CodeCatalyst で現在と今後のすべてのリポジトリにアクセスできるようにすることを選択するか、または CodeCatalyst で使用する特定の GitHub リポジトリを選択します。デフォルトのオプションでは、CodeCatalyst によってアクセスされる今後のリポジトリなど、GitHub アカウントにすべての GitHub リポジトリが含まれます。
1. CodeCatalyst に付与されているアクセス許可を確認してから、**[インストール]** を選択します。
GitHub アカウントを CodeCatalyst に接続すると、**[GitHub リポジトリ]** 拡張機能の詳細ページに移動します。このページでは、接続された GitHub アカウントとリンクされた GitHub リポジトリを表示および管理できます。
+ **Bitbucket リポジトリ**: Bitbucket ワークスペースに接続します。
1. Bitbucket の外部サイトに移動するには、**Bitbucket ワークスペースの接続]** を選択します。
1. Bitbucket 認証情報を使用して Bitbucket ワークスペースにサインインし、CodeCatalyst に付与されたアクセス許可を確認します。
1. **[ワークスペースの認証]** ドロップダウンメニューから、CodeCatalyst へのアクセスを許可する Bitbucket ワークスペースを選択し、**[アクセスを許可] ** を選択します。
**ヒント**
以前に Bitbucket ワークスペースをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。複数の Bitbucket ワークスペースのメンバーまたは共同作業者である場合は、拡張機能をインストールする場所を尋ねるダイアログが表示されます。1 つの Bitbucket ワークスペースのみに属している場合は、Amazon CodeCatalyst アプリケーションの設定ページが表示されます。ワークスペースのアクセスを許可するアプリケーションを設定し、**[アクセスを許可]** を選択します。**[アクセスを許可]** ボタンがアクティブでない場合は、設定を変更してから、再試行してください。
Bitbucket ワークスペースを CodeCatalyst に接続すると、**[Bitbucket リポジトリ]** 拡張機能の詳細ページに移動します。このページでは、接続された Bitbucket ワークスペースとリンクされた Bitbucket リポジトリを表示および管理できます。
+ **GitLab リポジトリ**: GitLab ユーザーに接続します。
1. **[GitLab ユーザーを接続]** を選択して、GitLab の外部サイトに移動します。
1. GitLab 認証情報を使用して GitLab ユーザーにログインし、CodeCatalyst に付与されたアクセス許可を確認します。
**ヒント**
以前に GitLab ユーザーをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。代わりに、CodeCatalyst コンソールに戻ります。
1. **GitLab の AWS コネクタの承認**を選択します。
GitLab ユーザーを CodeCatalyst に接続すると、**GitLab リポジトリ**拡張機能の詳細ページに移動します。このページでは、接続された GitLab ユーザーと、リンクされた GitLab プロジェクトリポジトリを表示および管理できます。
サードパーティーソースを CodeCatalyst に接続したら、サードパーティーリポジトリを CodeCatalyst プロジェクトにリンクできます。
**プロジェクトを作成するには**
1. **[プロジェクトの作成]** ページで、接続した GitHub アカウントを選択します。
1. 接続したサードパーティーリポジトリプロバイダーに応じて、**[GitHub リポジトリ]**、**[Bitbucket リポジトリ]**、または **[GitLab リポジトリ]**のリポジトリドロップダウンメニューを選択し、サードパーティーリポジトリを表示して、プロジェクトにリンクするリポジトリを選択します。
1. **[プロジェクトに名前を付ける]** テキスト入力フィールドに、プロジェクトに割り当てる名前を入力します。名前はスペース内で一意でなければなりません。
1. **[プロジェクトを作成]** を選択します。
**GitHub リポジトリ**、**Bitbucket リポジトリ**、または **GitLab リポジトリ**拡張機能をインストールし、リソースプロバイダーを接続して、サードパーティーリポジトリを CodeCatalyst プロジェクトにリンクしたら、それを CodeCatalyst ワークフローと開発環境で使用できます。ブループリントから生成されたコードを使用して、接続された GitHub アカウント、Bitbucket ワークスペース、または GitLab ユーザーでサードパーティーリポジトリを作成することもできます。リンクされたリポジトリは、Amazon Q Developer、ブループリントなどでも使用できます。詳細については、「[サードパーティーリポジトリイベント後にワークフローを自動的に開始](extensions-workflow-repositories.md)」および「[開発環境の作成](devenvironment-create.md)」を参照してください。
## ブループリントを使用したプロジェクトの作成
すべてのプロジェクトリソースとサンプルコードは、プロジェクトブループリントを使ってプロビジョニングできます。ブループリントについては、「[CodeCatalyst ブループリントを使用した包括的なプロジェクトの作成ブループリントを使用した包括的なプロジェクトの作成](project-blueprints.md)」を参照してください。
**ブループリントを使用してプロジェクトを作成する**
1. CodeCatalyst コンソールで、プロジェクトを作成するスペースに移動します。
1. スペースダッシュボードで、**[プロジェクトの作成]** を選択します。
1. **[ブループリントから始める]** を選択します。
**ヒント**
ブループリントを追加するには、**Amazon Q** にプロジェクト要件を入力すると、Amazon Q がブループリントを提案します。詳細については、「[プロジェクトの作成時または機能の追加時に Amazon Q を使用してブループリントを選択する](getting-started-project-assistance.md#getting-started-project-assistance-create-apply-bp)」および「[Amazon Q を使用したプロジェクトの作成やブループリントの機能追加のベストプラクティス](#projects-create-amazon-q)」を参照してください。この機能は、米国西部 (オレゴン) リージョンでのみ利用可能です。
この機能を使用するには、スペースに対して生成 AI 機能を有効にする必要があります。詳細については、「[Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)」を参照してください。
1. **[CodeCatalyst ブループリント]** タブまたは **[スペースブループリント]** タブで、ブループリントを選択し、**[次へ]** を選択します。
1. **[プロジェクトに名前を付ける]** で、プロジェクトに割り当てる名前と、関連するリソース名を入力します。名前はスペース内で一意でなければなりません。
1. (オプション) デフォルトでは、ブループリントが作成したソースコードは CodeCatalyst リポジトリに保存されます。または、ブループリントのソースコードをサードパーティーリポジトリに保存することもできます。詳細については、「[CodeCatalyst で拡張機能を持つプロジェクトに機能を追加する拡張機能を使用してプロジェクトに機能を追加する](extensions.md)」を参照してください。
**重要**
CodeCatalyst は、リンクされたリポジトリのデフォルトブランチの変更の検出をサポートしていません。リンクされたリポジトリのデフォルトブランチを変更するには、まず CodeCatalyst からリンクを解除し、デフォルトブランチを変更してから再度リンクする必要があります。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク](extensions-link.md)」を参照してください。
ベストプラクティスとして、リポジトリをリンクする前に、必ず最新バージョンの拡張機能があることを確認してください。
使用するサードパーティーリポジトリプロバイダーに応じて、次のいずれかを実行します。
+ **GitHub リポジトリ**: GitHub アカウントを接続します。
**[高度]** ドロップダウンメニューから、リポジトリプロバイダーとして GitHub を選択し、ブループリントによって作成されたソースコードを保存する GitHub アカウントを選択します。
**注記**
GitHub アカウントに接続している場合は、CodeCatalyst ID と GitHub ID 間の ID マッピングを確立するための個人用接続を作成する必要があります。詳細については、「[個人用接続](concepts.md#personal-connection-concept)」および「[個人接続を使用して GitHub リソースにアクセスする](ipa-settings-connections.md)」を参照してください。
+ **Bitbucket リポジトリ**: Bitbucket ワークスペースを接続します。
**[高度]** ドロップダウンメニューから、リポジトリプロバイダーとして Bitbucket を選択し、ブループリントによって作成されたソースコードを保存する Bitbucket ワークスペースを選択します。
+ **GitLab リポジトリ**: GitLab ユーザーを接続します。
**[高度]** ドロップダウンメニューから、リポジトリプロバイダーとして GitLab を選択し、ブループリントによって作成されたソースコードを保存する GitLab アカウントを選択します。
1. **[プロジェクトリソース]** で、ブループリントパラメータを設定します。ブループリントによっては、ソースリポジトリ名に名前を付けるオプションがある場合があります。
1. (オプション) 選択したプロジェクトパラメータに基づいて更新を伴う定義ファイルを表示するには、**[プロジェクトプレビューを生成]** から **[コードを表示]** または **[ワークフローを表示]** を選択します。
1. (オプション) ブループリントのカードから **[詳細を表示]** を選択すると、ブループリントのアーキテクチャの概要、必要な接続とアクセス許可、ブループリントで作成されるリソースの種類など、そのブループリントに関する具体的な情報が表示されます。
1. **[プロジェクトを作成]** を選択します。
## Amazon Q を使用したプロジェクトの作成やブループリントの機能追加のベストプラクティス
プロジェクトを作成する場合、または既存のプロジェクトに新しいコンポーネントを追加する場合、使用するブループリントや機能の統合方法がわからない場合があります。CodeCatalyst には Amazon Q と呼ばれる生成 AI アシスタントが統合されています。Amazon Q を使うと、プロジェクト要件を分析して、ニーズに最適なブループリントを提案できます。
Amazon Q を使用すると、要件に基づいてコンポーネントを作成するブループリントを備えたプロジェクトを作成できます。Amazon Q を使用して既存のプロジェクトにブループリントを追加することもできます。例えば、プロジェクトにウェブアプリケーションやモダンアプリケーションのリソースを追加するには、要件を指定すると、推奨されるブループリントにリソースが追加されます。残りのコンポーネントの問題も作成されます。
Amazon Q は、提案されたブループリントでは対処できない要件の問題を作成します。さらに、これらの問題を Amazon Q に割り当てることができます。問題を Amazon Q に割り当てると、評価用のソリューションの試案が作成されます。これにより、すぐにリソースを割くことができない問題の解決には Amazon Q を活用しながら、自分やチームは注意が必要な問題に集中して取り組むことで最適化を図ることができます。
**注記**
**Amazon Bedrock を利用**: [自動不正検出](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html) AWS を実装します。Amazon Q Developer Agent for Software Development の「**説明を記述する**」、「**内容の要約を作成する**」、「**タスクを提案する**」、「**Amazon Q を使用してプロジェクトに機能を作成または追加する**」、「**Amazon Q に問題を割り当てる**」機能は Amazon Bedrock を基盤に構築されているため、ユーザーは Amazon Bedrock に実装されている統制を最大限に活用して、AI の安全性、セキュリティ、責任ある使用を徹底することができます。
以下は、Amazon Q を使用して、プロジェクトを作成し、ブループリントを追加するためのベストプラクティスです。
**重要**
生成 AI 機能は、米国西部 (オレゴン) リージョンでのみ使用できます。
+ **Amazon Q が提供するデフォルトのプロンプトを使用します**。Amazon Q は、提供されたプロンプトに基づくブループリントを選択すると、最大限に効果を発揮します。
+ **Amazon Q が提案する設定オプションを使用して、ブループリントをプレビューします**。ブループリントを選択して、ブループリントで作成されたサンプルコードとリソースをプレビューします。
+ **Amazon Q が有効になっているスペースを使用します**。Amazon Q を使用してプロジェクトを作成したり、ブループリントを備えたプロジェクトに機能を追加したりするには、生成 AI 機能が有効になっているスペースを使用します。詳細については、「[スペースの生成 AI 機能の有効化または無効化](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-enable-disable)」を参照してください。
+ **Amazon Q が推奨するブループリントの詳細情報を取得します**。推奨されるブループリントで作成されたプロジェクトリソース、サンプルコード、コンポーネントの種類などを確認します。CodeCatalyst で使用可能なブループリントの詳細については、「[CodeCatalyst ブループリントを使用した包括的なプロジェクトの作成ブループリントを使用した包括的なプロジェクトの作成](project-blueprints.md)」を参照してください。
+ **Amazon Q で問題に対処できるようにします**。Amazon Q で問題を作成し、割り当てて、追跡できるようにします。詳細については、「[チュートリアル: CodeCatalyst の生成 AI 機能を使用して開発作業を高速化する](getting-started-project-assistance.md)」を参照してください。
+ **Amazon Q で対処されない問題の割り当てを解除します**。この例を完了したら、Amazon Q で対処されない問題の割り当てを解除します。Amazon Q が問題への対処を完了した場合、またはソリューションが見つからなかった場合は、Amazon Q の割り当てを解除して、生成 AI 機能のクォータ上限に達しないようにします。詳細については、「[Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)」および「[Pricing](https://codecatalyst.aws/explore/pricing)」を参照してください。
+ **Amazon Q の使用状況を表示します**。ユーザーレベルで生成 AI 機能の使用状況を表示できます。**[マイ設定]** に移動して、生成 AI クォータを管理し、ビルダー ID またはシングルサインオン (SSO) ID ごとの使用状況を表示します。詳細については、「[スペースでの生成 AI 機能の使用状況の表示](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-view-usage)」を参照してください。
**重要**
CodeCatalyst の生成 AI 機能は、クォータの対象となります。詳細については、[「Amazon Q Developer の料金](https://aws.amazon.com/q/developer/pricing/)」、「[スペースの生成 AI 機能の有効化または無効化](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-enable-disable)」、および「[請求](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html)」を参照してください。
## プロジェクトでブループリントを使用するためのベストプラクティス
以下は、ブループリントを使用してプロジェクトを作成したり、ブループリントを追加したりするためのベストプラクティスです。
+ **CodeCatalyst が提供するブループリントを使用して、プロジェクトを作成または追加します**。ブループリントを使用して、デベロッパー向けのソースコードとリソースを含む完全なプロジェクトを作成できます。例えば、ウェブアプリケーションのブループリントは、アプリケーションとインフラストラクチャのリソースを作成して、ウェブアプリケーションをデプロイします。ブループリントを使用してプロジェクトを作成したり、既存のプロジェクトにカスタムブループリントを追加したりできます。詳細については、「[ブループリントを使用したプロジェクトの作成](create-project-with-bp.md)」を参照してください。CodeCatalyst でブループリントを表示して、ブループリントで作成されるサンプルコードとリソースをプレビューします。
+ **組織によって設計されたカスタムブループリントを使用します**。カスタムブループリントを使用すると、完全なプロジェクトをスペースに作成できます。組織が設計したカスタムブループリントは、標準化とベストプラクティスを提供します。これによって新しいプロジェクトをセットアップする労力を低減できます。カスタムブループリントの作成者は、スペース全体でそのブループリントを使用しているプロジェクトの詳細を表示できます。ライフサイクル管理を使用すると、すべてのプロジェクトのソフトウェア開発ライフサイクルを一元管理できます。ブループリントユーザーは、ライフサイクル管理を使用すると、更新されたオプションまたはブループリントのバージョンからコードベースを再生成できます。詳細については、「[ブループリント作成者としてライフサイクル管理を使用する](lifecycle-management-dev.md)」を参照してください。
+ **デベロッパーロールまたは適切な IAM ロールをプロジェクト のアカウントに追加します**。プロジェクトの作成時または作成ステップの完了後、ブループリントのアクセス許可を設定するには、スペースに接続されている AWS アカウント の IAM ロールを選択するか、または作成します。
## 作成したプロジェクトへのリソースとタスクの追加
プロジェクトを作成したら、リソースとタスクを追加できます。
+ プロジェクトで作成された CI/CD ワークフローについては、「[初めてのワークフロー](workflows-getting-started.md)」を参照してください。
+ ビルドアクション (新しいプロジェクトのビルドアクションに類似) を行ってビルドアーティファクトを Amazon S3 バケットにデプロイするには、「[ワークフローを使用したビルド](build-workflow-actions.md)」および「[チュートリアル: Amazon S3 にアーティファクトをアップロードする](build-deploy.md)」を参照してください。
+ 空のプロジェクトから開始し、 CloudFormation スタックデプロイで同様のサーバーレスアプリケーションのデプロイを操作するには、「」を参照してください[チュートリアル: サーバーレスアプリケーションをデプロイする](deploy-tut-lambda.md)。
+ 問題計画ボードを追加するには、「[CodeCatalyst で問題を使用して作業の追跡と整理を行う問題を使用して作業を追跡して整理する](issues.md)」を参照してください。
+ プロジェクトの概要、プロジェクトステータス、最近のチームアクティビティ、割り当てられた作業を表示するには、「[プロジェクトのリストの取得](projects-view.md)」を参照してください。
+ ソースコードの表示、またはプルリクエストの作成については、「[CodeCatalyst のソースリポジトリでコードを保存し、共同作業を行うソースリポジトリでコードを保存して共同作業を行う](source.md)」を参照してください。
+ ワークフロー実行の成功または失敗のステータスアラートを送信する通知を設定するには、「[CodeCatalyst からの Slack 通知および E メール通知を送信する](notifications-manage.md)」を参照してください。
+ メンバーをプロジェクトに招待するには、「[ユーザーにプロジェクトアクセス許可を付与する](projects-members.md)」を参照してください。
+ 開発環境を設定するには、「[CodeCatalyst で開発環境を使用してコードを記述および変更する開発環境でコードを記述および変更する](devenvironment.md)」を参照してください。
# プロジェクトのリストの取得
CodeCatalyst スペースから、プロジェクトのアクセス許可がある各プロジェクトの詳細を表示できます。
プロジェクトを表示するには、プロジェクトのメンバーであるか、スペースの**スペース管理者**ロールを持っている必要があります。
まだプロジェクトを作成していない場合は、「[プロジェクトの作成](projects-create.md)」を参照してください。プロジェクトを作成するスペースの**スペース管理者**ロールを持っている必要があります。
+ プロジェクトの概要では、プロジェクトメンバー、ソースリポジトリ、ワークフロー実行、未解決のプルリクエスト、プロジェクト開発環境、および問題を表示できます。
+ プロジェクト設定では、プロジェクトの詳細の表示と管理、プロジェクトの削除、プロジェクトへの新規メンバーの招待、プロジェクトメンバーの管理、通知の設定を行うことができます。
## プロジェクトタスクと開発環境の表示
プロジェクトタスクの概要 (未解決の問題、割り当てられたプルリクエスト、作成したプルリクエスト、プロジェクトに関連付けられた開発環境など) を表示するには、コンソールを使用します。
プロジェクトを表示するには、プロジェクトのメンバーであるか、スペースの**スペース管理者**ロールを持っている必要があります。
**ソースリポジトリ、ワークフローの実行、問題、プルリクエスト、開発環境、問題を表示するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 表示するプロジェクトがあるスペースに移動します。**[プロジェクト]** で、プロジェクトを選択します。
1. ナビゲーションペインで、**[概要]** を選択します。
1. 割り当てられたプロジェクトタスクと作成したプロジェクトタスクが表示されます。
+ **[メンバー \$1 すべて表示]** でリストを表示して、プロジェクトメンバーのリストを表示します。
+ **[リポジトリ]** カードを表示して、プロジェクトに関連付けられているソースリポジトリを表示します。
+ **[ワークフロー実行]** カードを表示して、プロジェクトに関連付けられているワークフローを表示します。
+ **[未解決のプルリクエスト]** カードを表示して、コードリポジトリのステータスの概要、割り当てられたプルリクエスト、作成したプルリクエストを表示します。
+ **[開発環境]** カードを表示して、プロジェクトに関連付けられている開発環境の概要を表示します。
+ **[問題]** カードを表示して、割り当てられたタスクまたは作成したタスクの概要を表示します。
# スペース内のすべてのプロジェクトを表示する
スペースの**プロジェクト**リストでは、アクセス許可があるすべてのプロジェクトを表示できます。
プロジェクトタスクの概要 (未解決の問題、割り当てられたプルリクエスト、作成したプルリクエスト、プロジェクトに関連付けられた開発環境など) を表示するには、コンソールを使用します。
プロジェクトを表示するには、プロジェクトのメンバーであるか、スペースの**スペース管理者**ロールを持っている必要があります。
**ソースリポジトリ、ワークフローの実行、問題、プルリクエスト、開発環境、問題を表示するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 表示するプロジェクトがあるスペースに移動します。**[プロジェクト]** で、プロジェクトを選択します。
1. ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. プロジェクト名、パス、プロジェクト ID、説明を表示します。
## プロジェクト設定の表示
**[プロジェクト設定]** では、プロジェクトメンバー、ソースリポジトリ、ワークフロー実行、未解決のプルリクエスト、プロジェクト開発環境、問題が表示されます。
プロジェクトタスクの概要 (未解決の問題、割り当てられたプルリクエスト、作成したプルリクエスト、プロジェクトに関連付けられた開発環境など) を表示するには、コンソールを使用します。
**ソースリポジトリ、ワークフローの実行、問題、プルリクエスト、開発環境、問題を表示するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 表示するプロジェクトがあるスペースに移動します。**[プロジェクト]** で、プロジェクトを選択します。
1. ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. プロジェクト名、パス、プロジェクト ID、説明を表示します。
## CodeCatalyst で別のプロジェクトに変更する
別のプロジェクトに変更するには、コンソールを使用して、アクセスできるプロジェクトのリストから選択します。
**別のプロジェクトに変更するには**
1. CodeCatalyst コンソールで、上部のプロジェクトセレクタを選択します。
1. ドロップダウンを展開し、移動するプロジェクトを選択します。
# プロジェクトの削除
プロジェクトを削除して、プロジェクトのリソースへのすべてのアクセスを削除できます。プロジェクトを削除するには、スペース管理者またはプロジェクト管理者ロールが必要です。プロジェクトを削除すると、プロジェクトメンバーはプロジェクトリソースにアクセスできなくなります。サードパーティーのソースリポジトリからトリガーされるワークフローは停止します。
**プロジェクトを削除するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 表示するプロジェクトがあるスペースに移動します。**[プロジェクト]** で、プロジェクトを選択します。
1. ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. **[プロジェクトを削除]** を選択します。
1. **delete** と入力して削除を確定します。
1. **[プロジェクトを削除]** を選択します。
# ユーザーにプロジェクトアクセス許可を付与する
Amazon CodeCatalyst コンソールを使用して、プロジェクトのメンバーを管理できます。ユーザーの追加または削除、現在のメンバーのロールの管理、プロジェクトへの参加の招待の送信、まだ承諾されていない招待のキャンセルを行うことができます。
スペースおよびプロジェクトユーザーのメンバーページでは、ユーザーに複数のロールが設定されている場合があります。複数のロールを持つユーザーには、複数のロールがある場合にインジケータが表示され、最もアクセス許可の多いロールが最初に表示されます。
## メンバーとそのプロジェクトロールのリストを取得する
プロジェクトにユーザーを追加する場合には、プロジェクトのアクセス許可を付与するロールを次のように割り当てます。
+ **プロジェクト管理者**ロールには、プロジェクト内のすべてのアクセス許可があります。このロールは、プロジェクトのあらゆる側面を管理する必要があるユーザー (プロジェクト設定の編集、プロジェクトのアクセス許可の管理、プロジェクトの削除など) にのみ割り当てます。詳細については、「[プロジェクト管理者ロール](ipa-role-types.md#ipa-role-project-admin)」を参照してください。
+ **寄稿者**ロールには、プロジェクトで作業するために必要なアクセス許可があります。プロジェクトでコード、ワークフロー、問題、アクションを操作する必要があるユーザーにこのロールを割り当てます。詳細については、「[コントリビューターロール](ipa-role-types.md#ipa-role-contributor)」を参照してください。
+ **レビュアー**ロールには、レビューアクセス許可があります。詳細については、「[レビュアーロール](ipa-role-types.md#ipa-role-reviewer)」を参照してください。
+ **読み取り専用**ロールには、読み取りアクセス許可があります。詳細については、「[読み取り専用ロール](ipa-role-types.md#ipa-role-read-only)」を参照してください。
**スペース管理者**ロールを持つユーザーは、スペース内のすべてのプロジェクトに暗黙的にアクセスできるため、プロジェクトに招待する必要はありません。
(**スペース管理者**ロールを割り当てずに) プロジェクトにユーザーを招待すると、そのユーザーは、プロジェクトの**プロジェクトメンバー**テーブルと、スペースの**プロジェクトメンバー**テーブルの両方に表示されます。
**スペース内のユーザーとロールを表示するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 表示するプロジェクトがあるスペースに移動します。**[プロジェクト]** で、プロジェクトを選択します。
1. ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. **[メンバー]** タブを選択します。
**プロジェクトメンバー**テーブルには、プロジェクトにロールを持つすべてのメンバーが表示されます。
**ヒント**
**スペース管理者**ロールを持つユーザーは、直接招待されたプロジェクトを表示できます。プロジェクトの **[プロジェクト設定]** に移動し、**[マイプロジェクト]** を選択します。
**[スペース管理者]** テーブルには、**[スペース管理者]** ロールを持つユーザーが表示されます。これらのユーザーは、スペース内のすべてのプロジェクトに自動的に (暗黙的に) 割り当てられ、プロジェクトにロールはありません。
**[ステータス]** 列で有効な値は以下のとおりです。
+ **招待済み** – CodeCatalyst から招待が送信されましたが、ユーザーはまだ承諾または拒否していません。
+ **メンバー** – ユーザーは招待を承諾しました。
**Topics**
+ [メンバーとそのプロジェクトロールのリストを取得する](#projects-members-view)
+ [プロジェクトへのユーザーの招待](#projects-members-add)
+ [招待をキャンセルする](#projects-members-cancel-invite)
+ [プロジェクトからユーザーを削除する](#projects-members-remove)
+ [プロジェクトへの招待の承諾または拒否](#w2aac27c19c15c25)
## プロジェクトへのユーザーの招待
コンソールを使用して、プロジェクトにユーザーを招待できます。スペース内のメンバーを招待したり、スペース外のメンバーの名前を追加したりできます。
プロジェクトにユーザーを招待するには、**[プロジェクト管理者]** または **[スペース管理者]** のロールでサインインする必要があります。
**スペース管理者**ロールを持つユーザーは、スペース内のすべてのプロジェクトに暗黙的にアクセスできるため、プロジェクトに招待する必要はありません。
(**スペース管理者**ロールを割り当てずに) プロジェクトにユーザーを招待すると、そのユーザーは、プロジェクトの**プロジェクトメンバー**テーブルと、スペースの**プロジェクトメンバー**テーブルの両方に表示されます。
**プロジェクト設定タブからメンバーをプロジェクトに招待するには**
1. プロジェクトに移動します。
**ヒント**
上部のナビゲーションバーに表示するプロジェクトを選択できます。
1. ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. **[メンバー]** タブを選択します。
1. **[プロジェクトメンバー]** で、**[新しいメンバーの招待]** を選択します。
1. 新しいメンバーの E メールアドレスを入力し、このメンバーのロールを選択して、**[招待]** を選択します。ロールの詳細については、「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」をご参照ください。
**プロジェクトの概要ページからメンバーをプロジェクトに招待するには**
1. プロジェクトに移動します。
**ヒント**
上部のナビゲーションバーに表示するプロジェクトを選択できます。
1. **[メンバー \$1]** ボタンを選択します。
1. 新しいメンバーの E メールアドレスを入力し、このメンバーのロールを選択して、**[招待]** を選択します。ロールの詳細については、「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」をご参照ください。
## 招待をキャンセルする
最近招待を送信した場合、招待がまだ承諾されていない場合には、キャンセルできます。
プロジェクトの招待を管理するには、**プロジェクト管理者**または**スペース管理者**ロールが必要です。
**プロジェクトメンバーの招待をキャンセルするには**
1. キャンセルする招待を送信したプロジェクトに移動します。
1. ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. **[メンバー]** タブを表示し、メンバーのステータスが **[招待済み]** であることを確認します。
**注記**
キャンセルできるのは、まだ承諾されていない招待のみです。
1. 招待されたメンバーが表示されている行の横にあるオプションを選択し、**[招待をキャンセル]** を選択します。
1. 確認ウィンドウが表示されます。**[招待をキャンセル]** を選択して確定します。
## プロジェクトからユーザーを削除する
コンソールを使用して、プロジェクトからチームメンバーを削除できます。
プロジェクトからユーザーを削除するには、**プロジェクト管理者**または**スペース管理者**ロールでサインインする必要があります。
**注記**
スペース内のすべてのプロジェクトからユーザーを削除すると、そのユーザーはそのスペースから自動的に削除されます。
**プロジェクトからユーザーを削除するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 表示するプロジェクトがあるスペースに移動します。**[プロジェクト]** で、プロジェクトを選択します。
1. ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. **[メンバー]** タブを選択します。
1. 削除するプロファイルの横にあるセレクタを選択し、**[削除]** を選択します。
1. ユーザーを削除することを確認し、**[削除]** を選択します。
## プロジェクトへの招待の承諾または拒否
Amazon CodeCatalyst プロジェクトへの参加の招待メールが届いた場合には、招待を承認または拒否することができます。
**招待を承諾または辞退するには**
1. 招待メールを開きます。
1. E メール内のプロジェクトリンクを選択します。
1. **[承諾]** または **[拒否]** を選択します。
**[拒否]** を選択すると、招待を拒否したことを通知する E メールがプロジェクト管理アカウントに送信されます。
# チームを使用したプロジェクトアクセスの許可
プロジェクトを作成したら、チームを追加できます。チームを使用すると、ユーザーをグループ化して、アクセス許可を共有し、プロジェクトとスペースのメンバーとして CodeCatalyst 内のプロジェクト、問題追跡、ロール、リソースを管理できます。
プロジェクトのチームを管理するには、**プロジェクト管理者**ロールが必要です。
チームは CodeCatalyst のスペースレベルでも管理できます。スペース内のチームの詳細については、「[チームを使用してスペースアクセスを許可する](managing-teams.md)」を参照してください。
**Topics**
+ [プロジェクトへのチームの追加](projects-teams-add.md)
+ [チームへのプロジェクトロールの付与](projects-teams-project-roles.md)
+ [チームのプロジェクトロールの削除](projects-teams-remove.md)
# プロジェクトへのチームの追加
チームメンバーがプロジェクト内のリソースにアクセスできるように、チームを管理できます。
スペースおよびプロジェクトユーザーのメンバーページでは、ユーザーに複数のロールが設定されている場合があります。複数のロールを持つユーザーには、複数のロールがある場合にインジケータが表示され、最もアクセス許可の多いロールが最初に表示されます。
**チームを追加するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトに移動します。**[プロジェクト設定]** を選択し、次に **[チーム]** を選択します。
1. **[チームの追加]** を選択します。
1. **[チーム]** で、使用可能なチームのリストからチームを選択します。
1. **[プロジェクトロール]** で、CodeCatalyst で使用可能なプロジェクトロールのリストからロールを選択します。
+ **プロジェクト管理者** — 詳細については、「[プロジェクト管理者ロール](ipa-role-types.md#ipa-role-project-admin)」を参照してください。
+ **寄稿者** - 詳細については、「[コントリビューターロール](ipa-role-types.md#ipa-role-contributor)」を参照してください。
+ **レビュアー** - 詳細については、「[レビュアーロール](ipa-role-types.md#ipa-role-reviewer)」を参照してください。
+ **読み取り専用** — 詳細については、「[読み取り専用ロール](ipa-role-types.md#ipa-role-read-only)」を参照してください。
1. **[チームの追加]** を選択します。
# チームへのプロジェクトロールの付与
チームには、スペース内で**パワーユーザー**などのロールアクセス許可を付与することができます。チームのスペースロールは変更できますが、チームのすべてのメンバーにそのアクセス許可が継承されることに注意してください。
**プロジェクトロールを追加または変更するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 自分のスペースに移動します。**[プロジェクト設定]** を選択し、次に **[チーム]** を選択します。
1. ロールを変更するには、このリストのチームの横にあるセレクタを選択し、**[ロールの変更]** を選択します。ロールを追加するには、**[プロジェクトロールの追加]** を選択します。**[プロジェクト]** で追加するプロジェクトを選択し、**[ロール]**でロールを選択します。利用可能なプロジェクトロールのいずれかを選択します。
+ **プロジェクト管理者** - 詳細については、「[プロジェクト管理者ロール](ipa-role-types.md#ipa-role-project-admin)」を参照してください。
+ **コントリビューター** - 詳細については、「[コントリビューターロール](ipa-role-types.md#ipa-role-contributor)」を参照してください。
+ **レビュアー** - 詳細については、「[レビュアーロール](ipa-role-types.md#ipa-role-reviewer)」を参照してください。
+ **読み取り専用** - 詳細については、「[読み取り専用ロール](ipa-role-types.md#ipa-role-read-only)」を参照してください。
1. **[保存]** を選択します。
# チームのプロジェクトロールの削除
CodeCatalyst では、チームのプロジェクトロールを表示できます。チームのメンバーを表示することもできます。チームのプロジェクトロールを削除できます。
**プロジェクトロールを削除するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 自分のスペースに移動します。**[プロジェクト設定]** を選択し、次に **[チーム]** を選択します。
1. **[プロジェクトロール]** タブを選択します。
1. 削除するロールを選択します。
**重要**
チームからロールを削除すると、関連付けられているアクセス許可がチーム内のすべてのユーザーから削除されます。
1. **[保存]** を選択します。
# マシンリソースのプロジェクトアクセスの許可
マシンリソースは、CodeCatalyst のプロジェクトまたはスペースへのアクセス許可が付与された、CodeCatalyst の特定のリソースです。
**注記**
マシンリソースという用語は、クラウドインフラストラクチャ (EC2 インスタンスなど) を指すものではなく、スペースまたはプロジェクトのアクセス許可を持つブループリントまたはワークフローリソースを指します。
プロジェクトでマシンリソースを使用する例としては、プロジェクトへのアクセス許可をユーザーに代わってブループリントリソースに付与する場合などがあります。
マシンリソースは、許可されたリソースを備えたユーザーの代理となる ID で SSO を介して CodeCatalyst にアクセスします。マシンリソースを使うと、プロジェクト内のリソース (**ブループリント**や**ワークフロー**など) にアクセス許可を付与できます。プロジェクト内のマシンリソースを表示して、プロジェクトのマシンリソースを有効または無効にすることができます。例えば、マシンリソースを無効にしてアクセスを管理し、後で再度有効にすることができます。
これらの操作を使うと、マシンリソースを取り消したり無効にしたりすることができます。例えば、認証情報が侵害された可能性がある場合は、マシンリソースを無効にすることができます。通常、これらの操作を使用する必要はありません。
このページを表示してプロジェクトレベルでマシンリソースを管理するには、**スペース管理者**ロールまたは**プロジェクト管理者**ロールが必要です。
マシンリソースは、CodeCatalyst のスペースレベルでも管理されます。スペースやプロジェクトのチームの詳細については、「[マシンリソースのスペースアクセスを許可する](managing-machine-resources.md)」を参照してください。
**Topics**
+ [マシンリソースのプロジェクトアクセスの表示](projects-machine-resources-view.md)
+ [マシンリソースのプロジェクトアクセスの無効化](projects-machine-resources-disable.md)
+ [マシンリソースのプロジェクトアクセスの有効化](projects-machine-resources-enable.md)
# マシンリソースのプロジェクトアクセスの表示
プロジェクトで使用されているマシンリソースのリストを表示できます。
**スペース管理者**ロールまたは**プロジェクト管理者**ロールが必要です。
**マシンリソースを表示するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトに移動し、**[プロジェクト設定]** を選択します。**[マシンリソース]** を選択します。
1. ドロップダウンで、**[ワークフローアクション]** を選択して、ワークフローのマシンリソースのみを表示します。**[ブループリント]** を選択すると、ブループリントのマシンリソースのみが表示されます。
**[フィルター]** フィールドを使用すると、名前でフィルタリングできます。
# マシンリソースのプロジェクトアクセスの無効化
プロジェクトで使用されているマシンリソースを無効にすることができます。
**重要**
マシンリソースを無効にすると、スペース内の関連するすべてのブループリントまたはワークフローに対するすべてのアクセス許可が削除されます。
**スペース管理者**ロールまたは**プロジェクト管理者**ロールが必要です。
**マシンリソースを無効にするには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトに移動し、**[プロジェクト設定]** を選択します。**[マシンリソース]** を選択します。
1. 次のいずれかを選択します 。
**重要**
マシンリソースを無効にすると、スペース内の関連するすべてのブループリントまたはワークフローに対するすべてのアクセス許可が削除されます。
+ 個別に無効にするには、無効にする 1 つまたは複数のマシンリソースの横にあるセレクタを選択します。**[無効化]** を選択し、**[このリソース]** を選択します。
+ すべてのリソースを無効にするには、**[無効化]** を選択し、**[すべてのリソース]** を選択します。
+ すべてのワークフローアクションを無効にするには、**[無効化]** を選択し、**[すべてのワークフローアクション]** を選択します。
+ すべてのブループリントを無効にするには、**[無効化]** を選択し、**[すべてのブループリント]** を選択します。
# マシンリソースのプロジェクトアクセスの有効化
プロジェクトで使用され、無効になっているマシンリソースを有効にすることができます。
**スペース管理者**ロールまたは**プロジェクト管理者**ロールが必要です。
**マシンリソースを有効にするには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトに移動し、**[プロジェクト設定]** を選択します。**[マシンリソース]** を選択します。
1. 次のいずれかを選択します 。
+ 個別に有効にするには、有効にする 1 つまたは複数のマシンリソースの横にあるセレクタを選択します。**[有効化]** を選択し、**[このリソース]** を選択します。
+ すべてのリソースを有効にするには、**[有効化]** を選択し、**[すべてのリソース]** を選択します。
+ すべてのワークフローアクションを有効にするには、**[有効化]** を選択し、**[すべてのワークフローアクション]** を選択します。
+ すべてのブループリントを有効にするには、**[有効化]** を選択し、**[すべてのブループリント]** を選択します。
# プロジェクトのクォータ
次の表は、Amazon CodeCatalyst のプロジェクトのクォータと制限を示しています。Amazon CodeCatalyst でのクォータの詳細については、「[CodeCatalyst のクォータ](quotas.md)」を参照してください。
| | |
| --- |--- |
| スペースあたりのプロジェクトの最大数 | 100 |
| ユーザーが所属できるプロジェクトの最大数 | 1,000 |
| プロジェクトに所属できるメンバーの最大数。 | 10,000 |
| プロジェクト名 | プロジェクト名は、スペース内で一意である必要があります。名前は 3～63 文字にしてください。名前では、大文字と小文字が区別されます。プロジェクト名は英数字で始まる必要があります。有効な文字: **A-Z、a-z、0-9、スペース**、および **. , \$1(アンダースコア) - (ハイフン)** プロジェクト名に次の文字を含めることはできません: `! ? @ # $ % ^ & * ( ) + = { } [ ] \| \ / > < ~ ` ' " ; : ` |
| プロジェクトの説明 | プロジェクトの説明の長さは、最大 200 文字です。有効な文字: **A-Z、a-z、0-9、スペース**、および **. , \$1(アンダースコア) - (ハイフン)**。プロジェクトの説明はオプションです。 |
# CodeCatalyst からの通知を送信する
CodeCatalyst でプロジェクトとリソースをモニタリングするための通知を設定できます。ユーザーは、メンバーである任意のプロジェクトで E メールを受け取るプロジェクトイベントを選択できます。CodeCatalyst スペースと Slack ワークスペース間のアクセスを設定し、その Slack ワークスペース内の 1 つまたは複数のチャンネルに送信するプロジェクトの通知を設定することで、Slack などのチームメッセージングアプリケーション内のチーム全体に送信する通知を設定することもできます。CodeCatalyst スペースと Slack ワークスペース間のアクセスを設定すると、プロジェクトメンバーは自分の Slack メンバー ID を追加して、接続された Slack ワークスペースとチャンネルで CodeCatalyst イベントについて直接通知を受けることもできます。
**注記**
Slack に送信できるプロジェクトイベントのセットは、ユーザーが E メールで通知を受け取るように設定できるイベントセットと同じではありません。
**Topics**
+ [通知はどのような仕組みで機能しますか?](notifications-concepts.md)
+ [Slack 通知の使用開始](getting-started-notifications.md)
+ [CodeCatalyst からの Slack 通知および E メール通知を送信する](notifications-manage.md)
# 通知はどのような仕組みで機能しますか?
Slack などのチームメッセージングアプリケーションに通知を送信するようにプロジェクトを設定することができます。
## 通知には必要なアクセス許可
CodeCatalyst では、プロジェクトメンバーなら誰でも、チャンネルの通知設定の編集、表示、更新、削除を行うことができます。ただし、Slack ワークスペースを追加または削除できるのは、**スペース管理者**ロールを持つユーザーのみです。どのユーザーでも、CodeCatalyst で自分が属するプロジェクトにおいて、どのプロジェクトイベントに関する E メールを受け取りたいかを設定できます。
## 通知を設定できる CodeCatalyst イベント
ワークフローイベントに関する通知を 1 つまたは複数の Slack チャンネルに配信するように CodeCatalyst を設定できます。CodeCatalyst プロジェクトと Slack の間で通知が設定されると、プロジェクトユーザーは自分の Slack メンバー ID を追加して、CodeCatalyst イベントに関するダイレクトメッセージを Slack チャンネルで受け取ることができます。ユーザーが Slack メンバー ID を追加すると、プロジェクト用に設定された Slack チャンネルで各自の ID が直接メンションされ、それぞれ関心のあるイベントに関する認識を高めることができます。
どのイベントについて E メールを受け取るかを選択することもできます。これらの E メールは、 AWS ビルダー ID 用に設定された E メールアドレスに送信されます。
## 通知の配信方法
1 つまたは複数の Slack チャンネルに通知を配信するように CodeCatalyst を設定できます。CodeCatalyst に Slack ワークスペースへのアクセス許可を付与するように認可する必要があります。認可されると、CodeCatalyst は設定された Slack チャンネルに通知を配信できます。プロジェクトメンバーが Slack メンバー ID を追加すると、そのプロジェクト用に設定された Slack チャンネルで CodeCatalyst イベントに関するメンションを受け取ることができます。
## 通知の設定方法
E メール通知は CodeCatalyst の一部として設定されます。プロジェクトユーザーは、**[マイ設定]** ページで、どのイベントに関する E メールを受け取るかを選択できます。
プロジェクトリソースに対する Slack 通知を設定するには、次の大まかなタスクを完了する必要があります。
**通知を設定するには (概要レベルのタスク)**
1. CodeCatalyst では、CodeCatalyst と Slack などのメッセージングクライアント間の**接続を確立します**。Slack ワークスペースが接続されると、そのスペース内のすべてのプロジェクトで使用できるようになります。
**注記**
スペース管理者ロールを持つユーザーのみが Slack ワークスペースを追加または削除できます。
1. CodeCatalyst のプロジェクトで、チームが通知を受け取る**チャンネルを追加します**。
1. CodeCatalyst で、ワークフローの実行失敗などのさまざまなイベントの**通知を有効にし**、送信するチャネルを指定します。
詳細なステップについては、「[Slack 通知の使用開始](getting-started-notifications.md)」を参照してください。
CodeCatalyst スペースと Slack の間で通知が設定されると、ユーザーは自分の Slack メンバー ID を追加して、各自のプロジェクト用に設定された Slack チャンネルで CodeCatalyst イベントに関するダイレクトメッセージを受け取ることができます。
# Slack 通知の使用開始
プロジェクトを作成したら、チームがプロジェクトリソースをモニタリングするのに役立つ Slack 通知を設定できます。
これらのステップでは、CodeCatalyst で初めて Slack 通知を設定する方法について説明します。通知を既に設定している場合は、「[CodeCatalyst からの Slack 通知および E メール通知を送信する](notifications-manage.md)」を参照してください。
**注記**
通知チャネルに送信できるプロジェクトイベントのセットは、ユーザーが E メールで通知することを選択できるイベントセットと同じではありません。詳細については、「[CodeCatalyst からの Slack 通知および E メール通知を送信する](notifications-manage.md)」を参照してください。
**Topics**
+ [前提条件](#getting-started-notifications-prerequisites)
+ [ステップ 1: CodeCatalyst を Slack ワークスペースに接続する](#getting-started-notifications-connect-slack)
+ [ステップ 2: CodeCatalyst に Slack チャネルを追加する](#getting-started-notifications-add-slack-channel)
+ [ステップ 3: CodeCatalyst から Slack への通知をテストする](#getting-started-notifications-next-steps)
+ [ステップ 4: 次のステップ](#getting-started-notifications-test)
## 前提条件
開始するには、以下が必要です。
+ CodeCatalyst スペース。CodeCatalyst スペースの作成と初めてサインインする場合の詳細については、「[CodeCatalyst をセットアップしてサインインするCodeCatalyst をセットアップしてサインインする](setting-up-topnode.md)」を参照してください。
+ CodeCatalyst プロジェクト。詳細については、「[プロジェクトの作成](projects-create.md)」を参照してください。
+ **[プロジェクト管理者]** または **[スペース管理者]** ロールを持つ CodeCatalyst アカウント。詳細については、「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」を参照してください。
+ CodeCatalyst がアクセスできる Slack アカウントと Slack ワークスペース。
+ CodeCatalyst が通知を送信する Slack チャネル。チャンネルは、パブリックでもプライベートでもかまいません。
## ステップ 1: CodeCatalyst を Slack ワークスペースに接続する
**[スペース管理者]** ロールを持つユーザーのみが Slack ワークスペースを追加または削除できます。Slack ワークスペースを追加または削除すると、スペース内のすべてのプロジェクトに影響します。CodeCatalyst と Slack 間の接続を確立するために、CodeCatalyst は Slack ワークスペースで安全な OAuth 認証ハンドシェイクを実行します。
CodeCatalyst を Slack ワークスペースに接続するには、以下の手順に従います。
**注記**
これは、Slack ワークスペースごとに 1 回だけ実行する必要があります。その後、Slack チャネルで通知を設定できます。
**CodeCatalyst を Slack ワークスペースに接続するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトに移動します。
1. ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. **[通知]** タブを選択します。
1. **[通知の設定]** を選択します。
1. **[Slack ワークスペースに接続]** を選択します。
1. ダイアログボックスの内容を読み、**[Slack ワークスペースに接続]** を選択します。
1. **Amazon Q Developer in chat applications** のメッセージに対して、次の操作を行います。
1. 右上で、チャンネルを含む Slack ワークスペースを選択します。
1. [**許可**] を選択します。
CodeCatalyst コンソールに戻ります。
1. 「[ステップ 2: CodeCatalyst に Slack チャネルを追加する](#getting-started-notifications-add-slack-channel)」に進みます。
## ステップ 2: CodeCatalyst に Slack チャネルを追加する
CodeCatalyst にチャンネルを追加するには、Slack チャンネル ID が必要です。
**Slack チャンネル ID を取得するには**
1. Slack にサインインします。詳細については、「[Slack へのサインイン](https://slack.com/help/articles/212681477-Sign-in-to-Slack)」を参照してください。
1. 通知の送信先のチャネルを含む Slack ワークスペースに移動します。詳細については、「[Slack ワークスペースを切り替える](https://slack.com/help/articles/1500002200741-Switch-between-workspaces)」または「[追加の Slack ワークスペース にサインインする](https://slack.com/help/articles/212681477-Sign-in-to-Slack)」を参照してください。
1. ナビゲーションペインで、通知を行うチャンネルのコンテキスト (右クリック) メニューを開き、**[チャンネルの詳細を開く]** を選択します。
チャンネル ID はダイアログボックスの下部に表示されます。
1. **[チャンネル ID]** の値をコピーします。これは次のステップで必要になります。
コピーしたチャンネル ID を使用して、Slack チャンネルを CodeCatalyst に接続できるようになりました。
**Slack チャンネルを CodeCatalyst に追加するには**
1. 開始する前に、Slack チャンネルがプライベートの場合は、次のように Amazon Q Developer in chat applications をチャンネルに追加します。
1. Slack チャンネルのメッセージボックスに、 ダイアログボックスに「**@aws**」を入力し、**[aws アプリ]** を選択します。
1. [Enter] キーを押します。
Amazon Q Developer in chat applications がプライベートチャンネルにないことを示す Slackbot メッセージが表示されます。
1. **[招待する]** を選択して、Amazon Q Developer in chat applications をチャンネルに招待します。
1. CodeCatalyst コンソールで、**[次へ]** を選択します。
1. **[チャンネル ID]** で、前に取得した Slack チャンネル ID を貼り付けます。
1. **[チャンネル名]** に名前を入力します。Slack チャンネル名を使用することをお勧めします。
1. [**次へ**] を選択します。
1. **[通知イベントを選択]** で、通知を受け取るイベントを選択します。
1. [**Finish**] を選択してください。
## ステップ 3: CodeCatalyst から Slack への通知をテストする
ワークフローステータスの通知を送信するようにプロジェクトを設定したら、Slack で通知を表示できます。
**Slack で通知を表示するには**
1. CodeCatalyst プロジェクトで、ワークフローの実行を完了するために[ワークフローを手動で開始](workflows-manually-start.md)し、実行が完了するとステータス通知を受け取ります。
1. Slack で、通知用に設定したチャンネルを表示します。通知には、各ワークフロー実行の最新ステータスと、失敗したか成功したかが表示されます。
## ステップ 4: 次のステップ
CodeCatalyst スペースに Slack ワークスペースを設定したら、既存の CodeCatalyst プロジェクトを Slack チャネルに追加し、作成後に新しいプロジェクトに追加できます。また、プロジェクトユーザーに Slack メンバー ID の個人用 Slack 通知を設定し、E メールを受信するイベントを設定できることを知らせることもできます。詳細については、「[CodeCatalyst からの Slack 通知および E メール通知を送信する](notifications-manage.md)」を参照してください。
# CodeCatalyst からの Slack 通知および E メール通知を送信する
CodeCatalyst を設定して、プロジェクトで発生したイベントに関する通知を送信できます。CodeCatalyst は、Slack チャンネルなどのメッセージングクライアントに通知を送信できます。CodeCatalyst が Slack チャンネルにメッセージを送信することで、チーム全体がワークフローの失敗などの重要なイベントを認識できるようになります。対応するダイレクトメッセージ (DM) を受信できるように、CodeCatalyst が送信する Slack メッセージで @mention を使って自分をメンションさせることもできます。
CodeCatalyst は、E メールで通知をユーザーに直接送信することもできます。E メール通知は、ユーザーがメンバーであるプロジェクト内のイベントについて送信されます。こうした E メールは、AWS ビルダー ID で設定された E メールアドレスに送信されます。
**注記**
Slack チャンネルに送信できるイベントは、E メールで送信されるイベントとは異なる場合があります。
**Topics**
+ [E メール通知を設定する](notifications-personal.md)
+ [Slack チャンネルに通知を送信する](notifications-projects.md)
+ [Slack ダイレクトメッセージを設定する](notifications-personal-slack.md)
+ [通知チャネルの通知を編集する](notifications-edit.md)
+ [チャンネルを削除する](notifications-remove-channel.md)
# E メール通知を設定する
メンバーであるプロジェクトのイベントに関する E メール通知を受け取るように設定できます。こうした E メールは、 AWS ビルダー ID で設定された E メールアドレスに送信されます。デフォルトでは、E メール通知の対象となるすべてのプロジェクトイベントに関する E メールが送信されます。
**プロジェクトイベントの E メール通知を設定するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 上部のメニューバーでプロファイルバッジを選択し、**[My 設定]** を選択します。CodeCatalyst の **[マイ設定]** ページが開きます。
**ヒント**
ユーザープロファイルは、プロジェクトまたはスペースのメンバーページに移動し、メンバーリストから名前を選択することで見つけることができます。
1. **[E メール通知]** で、E メール通知を設定するリストでプロジェクトを検索し、**[編集]** を選択します。
1. E メールを受信するイベントを選択し、**[保存]** を選択します。
# Slack チャンネルに通知を送信する
CodeCatalyst を設定して、プロジェクトのイベントに関する通知をチームの Slack チャンネルに送信できます。これにより、ワークフローの実行が失敗した場合など、チーム全体が重要なイベントを認識できるようになります。
**注記**
プロジェクトのメンバーは誰でも、そのプロジェクトのチャンネルに送信される通知を管理できます。ただし、Slack ワークスペースを追加または削除できるのは、**スペース管理者**ロールを持つユーザーのみです。
通知を送信する Slack チャンネルを追加するには、次の手順を実行します。
**通知用の Slack チャンネルを追加するには**
1. 最初の Slack チャンネルを追加する場合は、代わりに「[Slack 通知の使用開始](getting-started-notifications.md)」を参照してください。
最初のチャンネルを設定したら、この手順に戻って追加のチャンネルを設定してください。
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトに移動します。
1. ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. **[通知]** タブを選択します。
1. **[チャンネルの追加]** を選択します。
1. **[workspace を選択]** を選択し、通知を送信するチャンネルを含む Slack ワークスペースを選択します。
Slack ワークスペースがリストにない場合は、「[Slack 通知の使用開始](getting-started-notifications.md)」の指示に従って追加します。
1. **[チャネル ID]** を入力する前に、追加する Slack チャンネルがプライベートの場合は、次の手順を実行します。
1. Slack チャンネルのメッセージボックスで、「**@aws**」と入力してポップアップから **[aws app]** を選択します。
1. Enter キーを押します。
Amazon Q Developer in chat applications がプライベートチャンネルにないことを示す Slackbot メッセージが表示されます。
1. **[招待する]** を選択して、Amazon Q Developer in chat applications をチャンネルに招待します。
1. CodeCatalyst の **[チャネル ID]** フィールドに、Slack チャンネル ID を入力します。ID を検索するには、Slack に移動し、ナビゲーションペインでチャンネルを右クリックして、**[Open channel details]** を選択します。
チャンネル ID はダイアログボックスの下部に表示されます。
1. **[チャネル名]** に名前を入力します。Slack チャンネル名を使用することをお勧めします。
1. **[通知イベントを選択]** で、通知を受け取るイベントを選択します。
1. **[Add]** (追加) を選択します。
# Slack ダイレクトメッセージを設定する
CodeCatalyst プロジェクトが [Slack チャンネルに通知を送信する](notifications-projects.md)ように設定されている場合、この通知はダイレクトメッセージ (DM) として送信することもできます。通知を DM として直接送信することで、ロールが割り当てられているプロジェクトで発生するイベントに対する認識を高めることができます。DM を有効にするには、Slack メンバー ID を CodeCatalyst に追加する必要があります。
**Slack ダイレクトメッセージを設定するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 上部のメニューバーでプロファイルバッジを選択し、**[My 設定]** を選択します。CodeCatalyst の **[マイ設定]** ページが開きます。
**ヒント**
ユーザープロファイルは、プロジェクトまたはスペースのメンバーページに移動し、メンバーリストから名前を選択することで見つけることができます。
1. **[個人用 Slack 通知]** で、**[Slack ID の接続]** を選択し、**[Slack ワークスペースに接続]** を選択します。別のウィンドウが開きます。
**ヒント**
このオプションは、**スペース管理者**ロールを持つユーザーが CodeCatalyst スペースに Slack ワークスペースを追加しない限り設定できません。詳細については、「[Slack 通知の使用開始](getting-started-notifications.md)」および「[Slack チャンネルに通知を送信する](notifications-projects.md)」を参照してください。
1. アクセス許可リクエストウィンドウで、ワークスペースの名前が CodeCatalyst スペース用に設定された Slack ワークスペースと一致することを確認します。**[許可]** を選択し、Amazon Q Developer in chat applications にワークスペースへのアクセスを許可します。ウィンドウが閉じ、Slack ワークスペースに **[Connection Status]** が **[Connected]** として表示されます。
**ヒント**
接続ステータスが変更されない場合は、Slack ワークスペースの接続でエラーが発生していないかどうかを確認します。エラーを表示するには、上にスクロールする必要がある場合があります。
1. 個人用 Slack 通知の受信を停止するには、接続された Slack ワークスペースを選択し、**[Slack ID の切断]** を選択します。
# 通知チャネルの通知を編集する
通知の送信先チャネルを変更したり、特定の通知を完全にオフにしたりできます。
**通知を編集するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトに移動します。
1. ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. **[通知]** タブを選択します。
1. **[通知の編集]** を選択します。
1. 次のいずれかを行います:
+ 特定のチャンネルに通知を送信するには、ドロップダウンリストからチャンネルを選択します。
+ 通知をグローバルにオフにするには、通知の横にあるトグルを選択します。
+ 特定のチャンネルへの通知の送信を停止するには、チャンネルの **[X]** をクリックします。
1. **[保存]** を選択します。
# チャンネルを削除する
Amazon CodeCatalyst から Slack チャンネルを削除できます。Slack チャンネルを削除することで、選択した CodeCatalyst プロジェクトに関する通知はチャンネルに送信されなくなります。
**チャンネルを削除するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトに移動します。ナビゲーションペインで、**[プロジェクト設定]** を選択します。
1. **[プロジェクト設定]** ページで、**[通知]** タブを選択します。
1. 削除するチャンネルの横にあるインジケータを選択し、**[チャンネルの削除]** を選択します。確認ウィンドウで、**[OK]** をクリックします。