ソースリポジトリの概念

CodeCatalyst ソースリポジトリを使用する際に知っておくべき概念をいくつか紹介します。

プロジェクト

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

ソースリポジトリは、スペース内で作成またはリンクするプロジェクトに固有です。プロジェクト間でリポジトリを共有したり、リポジトリをスペース内の複数のプロジェクトにリンクしたりすることはできません。プロジェクトに Contributor またはプロジェクト管理者ロールを持つユーザーは、それらのロールに付与されたアクセス許可に従って、そのプロジェクトに関連付けられたソースリポジトリとやり取りできます。詳細については、「ユーザーロールによるアクセスの許可」を参照してください。

ソースリポジトリ

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

開発環境

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

ソースリポジトリの既存のブランチを開発環境にクローンするか、開発環境の作成の一環として新しいブランチを作成するかを選択できます。

個人用アクセストークン (PATs)

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

統合開発環境 (IDEsを使用する場合、PATs は Git パスワードと同等です。Git リポジトリと連携するように IDE を設定するときにパスワードを求められたら、PAT を指定します。IDE を Git ベースのリポジトリに接続する方法の詳細については、IDE のドキュメントを参照してください。

ブランチ

ブランチは、Git および のコミットへのポインタまたは参照です CodeCatalyst。ブランチを使用して作業を整理できます。例えば、ブランチを使用して、他のブランチのファイルに影響を与えずに、新しいバージョンまたは異なるバージョンのファイルを操作することができます。ブランチを使用して、新機能の開発、プロジェクトの特定のバージョンの保存などを行うことができます。ソースリポジトリには、1 つのブランチまたは複数のブランチを含めることができます。テンプレートを使用してプロジェクトを作成すると、プロジェクト用に作成されたソースリポジトリには、メイン というブランチのサンプルファイルが含まれます。メインブランチはリポジトリのデフォルトブランチです。

デフォルトのブランチ

のソースリポジトリ CodeCatalyst には、作成方法に関係なくデフォルトのブランチがあります。テンプレートを使用してプロジェクトを作成する場合、そのプロジェクト用に作成されたソースリポジトリには、サンプルコード、ワークフロー定義、その他のリソースに加えて README.md ファイルが含まれます。テンプレートを使用せずにソースリポジトリを作成すると、README.md ファイルが最初のコミットとして追加され、リポジトリの作成の一環としてデフォルトのブランチが作成されます。このデフォルトのブランチは main という名前です。このデフォルトブランチは、ユーザーがリポジトリをクローンするときに、ローカルリポジトリのベースブランチまたはデフォルトブランチとして使用されるブランチです。デフォルトブランチとして使用されるブランチを変更できます。詳細については、「リポジトリのデフォルトブランチの管理」を参照してください。

ソースリポジトリのデフォルトブランチは削除できません。検索結果には、デフォルトのブランチの結果のみが含まれます。

コミット

コミットとは、ファイルまたはファイルのセットに対する変更です。Amazon CodeCatalyst コンソールでは、コミットによって変更が保存され、ソースリポジトリにプッシュされます。コミットには、変更を行ったユーザーのアイデンティティ、変更日時、コミットタイトル、変更に関するメッセージなど、変更に関する情報が含まれます。詳細については、「Amazon でのコミットによるソースコードの変更について CodeCatalyst」を参照してください。

のソースリポジトリのコンテキストでは CodeCatalyst、コミットはコンテンツのスナップショットであり、リポジトリの内容に対する変更です。コミットに Git タグを追加して、特定のコミットを識別することもできます。

プルリクエスト

プルリクエストは、ユーザーや他のユーザーがソースリポジトリ内のブランチ間でコードの変更を確認、コメント、マージする主な方法です。プルリクエストを使用して、リリースされたソフトウェアのマイナーな変更や修正、主要な機能の追加、新しいバージョンのコード変更を共同で確認できます。プルリクエストでは、送信元ブランチと送信先ブランチの変更、またはそれらのブランチのリビジョンの違いを確認できます。個々のコード変更行にコメントを追加したり、プルリクエスト全体に対するコメントを追加したりできます。

ヒント

プルリクエストの作成中に表示される違いは、ソースブランチのチップと宛先ブランチのチップの違いです。プルリクエストが作成されると、表示される違いは、選択したプルリクエストのリビジョンと、プルリクエストの作成時に送信先ブランチのヒントであったコミットの間になります。Git の違いとマージベースの詳細については、Git ドキュメントgit-merge-baseの「」を参照してください。

リビジョン

リビジョンは、プルリクエストの更新バージョンです。プルリクエストの送信元ブランチへのプッシュごとに、そのプッシュに含まれるコミットに加えられた変更を含むリビジョンが作成されます。プルリクエストのリビジョン間の違いは、送信元ブランチと送信先ブランチの違いに加えて表示できます。詳細については、「Amazon でのプルリクエストによるコードの確認 CodeCatalyst」を参照してください。

ワークフロー

ワークフローは、継続的インテグレーションおよび継続的デリバリー (CI/CD) システムの一部としてコードを構築、テスト、デプロイする方法を説明する自動化された手順です。ワークフローは、ワークフローの実行中に実行する一連のステップまたはアクションを定義します。ワークフローは、ワークフローを開始するイベント、またはトリガー も定義します。ワークフローを設定するには、 CodeCatalyst コンソールのビジュアルまたは YAML エディタ を使用してワークフロー定義ファイルを作成します。

ヒント

プロジェクトでワークフローを使用する方法を簡単に確認するには、設計図 を使用してプロジェクトを作成します。各ブループリントは、レビュー、実行、および実験できる機能するワークフローをデプロイします。

ソースリポジトリは、プロジェクトのワークフロー、通知、問題、その他の設定情報の設定ファイルやその他の情報を保存することもできます。設定ファイルは、設定ファイルを必要とするリソースを作成するとき、またはワークフローのソースアクションとしてリポジトリを指定するときに、ソースリポジトリに作成および保存されます。設計図からプロジェクトを作成する場合、プロジェクトの一部として作成されたソースリポジトリに設定ファイルが既に保存されています。この設定情報は、リポジトリのデフォルトブランチ.codecatalystにある という名前のフォルダに保存されます。デフォルトブランチのブランチを作成するときは、そのブランチ内の他のすべてのファイルとフォルダに加えて、このフォルダとその設定のコピーを作成します。