

Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

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

# CodeCatalyst の概念
<a name="concepts"></a>

Amazon CodeCatalyst でのコラボレーションとアプリケーション開発を高速化するのに役立つ主要な概念を理解してください。これらの概念には、ソースコントロール、継続的統合と継続的配信 (CI/CD)、自動リリースプロセスのモデリングと設定に使用される用語が含まれます。

その他の概念的な情報については、以下のトピックを参照してください。
+ [ソースリポジトリに関する概念](source-concepts.md)
+ [ワークフローの概念](workflows-concepts.md)

**Topics**
+ [AWS CodeCatalyst のビルダー ID スペース](#concepts-spaces)
+ [CodeCatalyst で ID フェデレーションをサポートするスペース](#space-federated)
+ [プロジェクト](#project-concept)
+ [ブループリント](#templates-concept)
+ [アカウント接続](#account-connections-concept)
+ [VPC 接続](#vpc-connections-concept)
+ [AWS ビルダー ID](#sign-in-concept)
+ [CodeCatalyst のユーザープロファイル](#user-profile-concept)
+ [ソースリポジトリ](#source-repositories-concept)
+ [コミット](#commits-concept)
+ [開発環境](#devenvironment-concept)
+ [ワークフロー](#workflow-concept)
+ [アクション](#action-concept)
+ [問題](#issues-concept)
+ [個人用アクセストークン (PAT)](#personal-access-token-concept)
+ [個人用接続](#personal-connection-concept)
+ [ロール](#role-concept)

## AWS CodeCatalyst のビルダー ID スペース
<a name="concepts-spaces"></a>

スペース管理者は、メンバーページから個々の招待メールを送信することで、ユーザーを CodeCatalyst に招待します。CodeCatalyst に招待またはサインアップされたユーザーは、独自の AWS Builder ID を作成します。プロファイルは AWS Builder ID で管理され、CodeCatalyst のユーザー設定にユーザー名およびプロファイル情報として表示されます。

## CodeCatalyst で ID フェデレーションをサポートするスペース
<a name="space-federated"></a>

IAM アイデンティティセンターインスタンスの SSO ユーザーとグループに追加され、ID ストアで管理され、IAM アイデンティティセンターを介してスペースに招待されたユーザー。**[スペース管理者]** は、CodeCatalyst メンバーページを最新の更新と同期します。ユーザーは、会社の IAM アイデンティティセンターインスタンスで設定された SSO サインインポータルを使用してサインインします。ID フェデレーションをサポートするスペースは、アイデンティティセンターアプリケーションと ID ストア ID へのマッピングを介して ID ストアインスタンスに接続されます。

## プロジェクト
<a name="project-concept"></a>

*プロジェクト*とは、CodeCatalyst における共同作業のことを指し、開発チームやタスクをサポートします。プロジェクトを作成すると、リソースの追加、更新、削除、プロジェクトダッシュボードのカスタマイズ、チームの作業進捗のモニタリングを行えます。1 つのスペースに複数のプロジェクトを含めることができます。

プロジェクトに関する詳細については、「[CodeCatalyst のプロジェクトの作業を整理するプロジェクトの作業を整理する](projects.md)」を参照してください。

## ブループリント
<a name="templates-concept"></a>

*ブループリント*は、コンソールで CodeCatalyst プロジェクトを作成するとともに、アプリケーションサポートファイルと依存関係を生成して拡張するプロジェクトシンセサイザーです。CodeCatalyst のブループリントの選択からプロジェクトタイプを選択し、README ファイルを表示し、生成されるプロジェクトリポジトリとリソースをプレビューします。プロジェクトは、ブループリントで指定されたベース設定から生成されます。プロジェクトブループリントに定期的に合成すると、ソフトウェアの依存関係などのプロジェクトファイルが更新され、リソースが再生成されます。プロジェクトは Projen と呼ばれるツールを使用して、最新のプロジェクト更新を同期し、サポートファイルを生成してプロジェクトを合成します。これらのファイルには、アプリケーションタイプ、言語に基づいて、`package.json`、`Makefile`、`eslint` などが含まれます。プロジェクトのブループリントは、CDK コンストラクト、 CloudFormation テンプレート、 AWS Serverless Application Model テンプレートなどの AWS リソースをサポートするファイルを生成できます。

ブループリントの詳細については、「[CodeCatalyst ブループリントを使用した包括的なプロジェクトの作成ブループリントを使用した包括的なプロジェクトの作成](project-blueprints.md)」を参照してください。

## アカウント接続
<a name="account-connections-concept"></a>

*[アカウント接続]* は、CodeCatalyst スペースを AWS アカウントに関連付けます。アカウント接続がセットアップされると、 AWS アカウント はスペースで利用可能になります。その後、CodeCatalyst に IAM ロールを追加して、 のリソースにアクセスできるようになります AWS アカウント。CodeCatalyst ワークフローアクションには、これらのロールを使用することもできます。

プロジェクト制限付きアカウント接続を有効にすることで、アカウント接続にアクセスできるプロジェクトとリソースを制限できます。*プロジェクト制限付きアカウント接続*は、スペース内の指定されたプロジェクト AWS アカウント のみがアクセスできる接続です。これにより、スペース内のチームは、プロジェクトごとに統合された AWS リソースの AWS アカウント の使用を制限できます。例えば、特定のプロジェクトでデプロイワークフローと VPC 接続に使用されるアカウントは、プロジェクト制限されたアカウント接続でのみ使用できます。詳細については、[「プロジェクト制限アカウント接続の設定](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction)」を参照してください。

アカウント接続の詳細については、「[接続された AWS リソースへのアクセスを許可する AWS アカウント](ipa-connect-account.md)」を参照してください。

## VPC 接続
<a name="vpc-connections-concept"></a>

*[VPC 接続]* は CodeCatalyst リソースであり、ワークフローが VPC にアクセスするために必要なすべての設定が含まれています。スペース管理者は、スペースメンバーの代わりに Amazon CodeCatalyst コンソールに独自の VPC 接続を追加できます。VPC 接続を追加することで、スペースメンバーはワークフローアクションを実行し、ネットワークルールに準拠し、関連する VPC 内のリソースにアクセスできる開発環境を作成できます。

VPC 接続の詳細については、「*CodeCatalyst 管理者ガイド*」の「[Amazon Virtual Private Clouds の管理](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.html)」を参照してください。

## AWS ビルダー ID
<a name="sign-in-concept"></a>

 AWS Builder ID は、CodeCatalyst やその他の参加アプリケーションへのサインアップとサインインに使用できる個人 ID です。これは と同じではありません AWS アカウント。 AWS Builder ID は、ユーザーエイリアスや E メールアドレスなどのメタデータを管理します。 AWS ビルダー ID は、CodeCatalyst のすべてのスペースでユーザーをサポートする一意の ID です。 AWS Builder ID プロファイルへのアクセスについては、「」を参照してください[プロファイルの更新](your-profile.md)。 AWS Builder ID の詳細については、の[AWS 「Builder ID](https://docs.aws.amazon.com/general/latest/gr/aws_builder_id.html)」を参照してください AWS 全般のリファレンス。

サインアップとサインインの詳細については、「[CodeCatalyst をセットアップしてサインインするCodeCatalyst をセットアップしてサインインする](setting-up-topnode.md)」を参照してください。

## CodeCatalyst のユーザープロファイル
<a name="user-profile-concept"></a>

CodeCatalyst ユーザープロファイルにアクセスするには、CodeCatalyst の任意のページのログインイニシャルの下にあるドロップダウンからプロファイルオプションを選択します。プロファイルページから個人用アクセストークン (PAT) を作成できますが、 AWS CLIを使用しなければ PAT の表示または削除はできません。ユーザー名は、サインアップ時に選択したエイリアスです。ユーザー名は変更できません。別の CodeCatalyst ユーザーのプロファイルページを表示するには、プロジェクトの **[メンバー]** タブに移動し、適切なユーザーを選択します。

 AWS ビルダー ID にアクセスするには、CodeCatalyst プロファイルを表示し、 を選択して AWS ビルダー ID に移動します。Builder ID AWS プロファイルページにリダイレクトされます。プロファイルのフルネーム、E メールアドレス、パスワードは AWS Builder ID によって管理され、 AWS Builder ID ページを使用してその情報を編集できます。サインアップ時にこの情報を入力しました。サインインに認証アプリケーションを使用するように MFA を設定する準備ができたら、 AWS ビルダー ID ページを使用します。 AWS Builder ID プロファイルの表示の詳細については、「」を参照してください[プロファイルの更新](your-profile.md)。

サインアップとサインインの詳細については、「[CodeCatalyst をセットアップしてサインインするCodeCatalyst をセットアップしてサインインする](setting-up-topnode.md)」を参照してください。

## ソースリポジトリ
<a name="source-repositories-concept"></a>

*ソースリポジトリ*とは、プロジェクトのコードとファイルを安全に保存する場所です。また、ファイルのバージョン履歴も保管されます。デフォルトでは、ソースリポジトリは CodeCatalyst プロジェクトの他のユーザーと共有されます。1 つのプロジェクトに複数のソースリポジトリを持つことができます。CodeCatalyst でプロジェクトのソースリポジトリを作成するか、インストールされた拡張機能でそのサービスがサポートされている場合は、別のサービスがホストしている既存のソースリポジトリをリンクすることができます。例えば、**GitHub リポジトリ拡張機能**をインストールした後、GitHub リポジトリをプロジェクトにリンクできます。詳細については、「[CodeCatalyst のプロジェクト用リポジトリにソースコードを保存する](source-repositories.md)」および「[クイックスタート: CodeCatalyst での拡張機能のインストール、プロバイダーの接続、リソースのリンク](extensions-quickstart.md)」を参照してください。

ソースリポジトリは、CI/CD ワークフローの属性とアクションを定義する設定ファイルなど、CodeCatalyst プロジェクトの設定情報を保存する場所でもあります。ブループリントを使用してプロジェクトを作成すると、ソースリポジトリが作成され、その中にプロジェクト設定情報が保存されます。空のプロジェクトを作成する場合は、ワークフローなどの設定情報を必要とするリソースを作成する前に、ソースリポジトリを作成する必要があります。

ソースリポジトリとソースコントロールの操作に役立つその他の概念については、「[ソースリポジトリに関する概念](source-concepts.md)」を参照してください。

## コミット
<a name="commits-concept"></a>

*[コミット]* は、1 つのファイルまたはファイル一式に対する変更です。Amazon CodeCatalyst コンソールでは、コミットによって変更が保存され、ソースリポジトリにプッシュされます。コミットには、変更を行ったユーザー ID、変更日時、コミットタイトル、変更に関するメッセージなど、変更に関する情報が含まれます。詳細については、「[Amazon CodeCatalyst におけるコミットによるソースコードの変更を理解する](source-commits.md)」を参照してください。

CodeCatalyst のソースリポジトリのコンテキストでは、コミットとはリポジトリの内容に対する変更のスナップショットです。ユーザーが変更をコミットしてプッシュするたびに、CodeCatalyst は誰が変更をコミットしたか、コミットした日時、コミットの一部として行われた変更を含む情報を保存します。コミットに Git タグを追加して、特定のコミットの識別に役立てることもできます。

コミットの詳細については、「[Amazon CodeCatalyst におけるコミットによるソースコードの変更を理解する](source-commits.md)」を参照してください。

## 開発環境
<a name="devenvironment-concept"></a>

*開発環境*は、プロジェクトのソースリポジトリに保存されているコードを操作するために CodeCatalyst で素早く使用できるクラウドベースの開発環境です。開発環境に含まれるプロジェクトツールとアプリケーションライブラリは、プロジェクトのソースリポジトリ内の devfile によって定義されます。ソースリポジトリに devfile がない場合は、デフォルトの devfile が自動的に適用されます。デフォルトの devfile には、最も頻繁に使用されるプログラミング言語とフレームワーク用のツールが含まれています。デフォルトでは、開発環境は 2 コアプロセッサ、4 GB の RAM、16 GB の永続ストレージで作成されます。

## ワークフロー
<a name="workflow-concept"></a>

*ワークフロー*は、CI/CD (Continuous Integration/Continuous Delivery) システムの一部としてコードを構築、テスト、デプロイする方法を説明する自動手順です。ワークフローは、ワークフローの実行中に実行する一連のステップまたは*アクション*を定義します。ワークフローは、ワークフローを開始するイベント、または*トリガー*も定義します。ワークフローを設定するには、CodeCatalyst コンソールの[ビジュアルエディタまたは YAML エディタ](https://docs.aws.amazon.com//codecatalyst/latest/userguide/flows.html#workflow.editors)を使用して*ワークフロー定義ファイル*を作成します。

**ヒント**  
プロジェクトでワークフローを使用する方法を簡単に確認するには、[ブループリントを使用してプロジェクトを作成](https://docs.aws.amazon.com//codecatalyst/latest/userguide/projects-create.html#projects-create-console-template)します。各ブループリントは、レビュー、実行、実験可能な機能するワークフローをデプロイします。

ワークフローの詳細については、「[ワークフローを使用して構築、テスト、デプロイするワークフローを使用して構築、テスト、デプロイする](workflow.md)」を参照してください。

## アクション
<a name="action-concept"></a>

*アクション*はワークフローの主要な構成要素であり、ワークフローの実行中に実行する作業またはタスクの論理単位を定義します。通常、ワークフローには、設定方法に応じて順次または並列に実行される複数のアクションが含まれます。

アクションの詳細については、「[ワークフローアクションの構成](workflows-actions.md)」を参照してください。

## 問題
<a name="issues-concept"></a>

*問題*は、プロジェクトに関連する作業を追跡するレコードです。プロジェクトに関連する機能、タスク、バグなど、あらゆる作業に対して問題を作成できます。アジャイル開発を使用している場合、問題はエピックまたはユーザーストーリーを記述することもできます。

問題を解決する方法の詳細については、「[CodeCatalyst で問題を使用して作業の追跡と整理を行う問題を使用して作業を追跡して整理する](issues.md)」を参照してください。

## 個人用アクセストークン (PAT)
<a name="personal-access-token-concept"></a>

*パーソナルアクセストークン* (PAT) はパスワードに似ています。CodeCatalyst のすべてのスペースとプロジェクトで使用できるように、ユーザー ID に関連付けられています。PAT を使用して、統合開発環境 (IDE) と Git ベースのソースリポジトリを含む CodeCatalyst リソースにアクセスします。PAT は、CodeCatalyst でユーザー自身を表し、これはユーザー設定で管理できます。ユーザーは複数の PAT を持つことができます。個人用アクセストークンは 1 回のみ表示されます。ベストプラクティスとして、必ずローカルコンピュータに安全に保存してください。デフォルトでは、PAT 1 年後に期限切れになります。

タグの詳細については、[個人用アクセストークンを使用してリポジトリアクセスをユーザーに付与する](ipa-tokens-keys.md) を参照してください。

## 個人用接続
<a name="personal-connection-concept"></a>

*個人用接続*は、CodeCatalyst ID と GitHub などの外部ソースプロバイダー間の認可です。個人用接続を使用して、CodeCatalyst ユーザーがサードパーティーのソースリポジトリを追加できるようにします。例えば、GitHub リポジトリを CodeCatalyst スペースに接続できます。インストールされたコネクタアプリケーションは、アカウント所有者によって指定されたリポジトリで使用するため、GitHub アカウントにインストールされます。GitHub などの特定のプロバイダータイプのすべてのスペースで、1 つのユーザー ID (CodeCatalyst エイリアス) に対して 1 つの個人用接続を作成できます。個人用接続は、 AWS ビルダー ID または SSO ユーザーに関連付けられます。

詳細については、「[個人接続を使用して GitHub リソースにアクセスする](ipa-settings-connections.md)」を参照してください。

## ロール
<a name="role-concept"></a>

*ロール*は、プロジェクトまたはスペースのリソースへのユーザーのアクセスと、ユーザーが実行できるアクションを定義します。プロジェクトに招待するときに、ユーザーのロールを選択します。CodeCatalyst には、スペースレベルのロールとプロジェクトレベルのロールがあります。正しいレベルの管理ロールを持つユーザーは、割り当てられたロールを変更できます。例えば、プロジェクトの **[プロジェクト管理者]** ロールを持つユーザーは、そのプロジェクトを完全に制御でき、そのプロジェクトのユーザーロールを変更できます。使用可能なロールと各ロールに付与されているアクセス許可については、「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」を参照してください。

ロールの詳細については、「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」をご参照ください。