Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ワークフローへのソースリポジトリの接続
*ソース*は*入力ソース*とも呼ばれ、[ワークフローアクション](workflows-actions.md)がオペレーションの実行に必要なファイルを取得するために接続するソースリポジトリです。例えば、ワークフローアクションがソースリポジトリに接続して、アプリケーションを構築するためにアプリケーションソースファイルを取得する場合があります。
CodeCatalyst ワークフローでは次のソースをサポートしています。
+ CodeCatalyst ソースリポジトリ — 詳細については、「[CodeCatalyst のソースリポジトリでコードを保存し、共同作業を行うソースリポジトリでコードを保存して共同作業を行う](source.md)」を参照してください。
+ GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ – 詳細については、「[CodeCatalyst で拡張機能を持つプロジェクトに機能を追加する拡張機能を使用してプロジェクトに機能を追加する](extensions.md)」を参照してください。
**Topics**
+ [ワークフローファイルのソースリポジトリの指定](workflows-sources-specify-workflow-def.md)
+ [ワークフローアクションのソースリポジトリの指定](workflows-sources-specify-action.md)
+ [ソースリポジトリファイルの参照](workflows-sources-reference-files.md)
+ [「BranchName」変数と「CommitId」変数](workflows-sources-variables.md)
# ワークフローファイルのソースリポジトリの指定
次の手順に従って、ワークフロー定義ファイルを保存する CodeCatalyst ソースリポジトリを指定します。GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを指定する場合は、代わりに「[CodeCatalyst で拡張機能を持つプロジェクトに機能を追加する拡張機能を使用してプロジェクトに機能を追加する](extensions.md)」を参照してください。
ワークフロー定義ファイルが存在するソースリポジトリには「`WorkflowSource`」というラベルが付きます。
**注記**
ワークフロー定義ファイルを最初にコミットするときに、ワークフロー定義ファイルが存在するソースリポジトリを指定します。このコミットの後、リポジトリとワークフロー定義ファイルは永続的に相互リンクされます。最初のコミットの後にリポジトリを変更する唯一の方法は、別のリポジトリでワークフローを再作成することです。
**ワークフロー定義ファイルを保存するソースリポジトリを指定するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトを選択します。
1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。
1. **[ワークフローの作成]** を選択してワークフローを作成します。詳細については、「[ワークフローの作成](workflows-create-workflow.md)」を参照してください。
ワークフロー作成プロセス中に、ワークフロー定義ファイルを保存する CodeCatalyst リポジトリ、ブランチ、フォルダを指定できます。
# ワークフローアクションのソースリポジトリの指定
次の手順に従って、ワークフローアクションで使用するソースリポジトリを指定します。起動時に、アクションは構成済みソースリポジトリのファイルをアーティファクトにバンドルし、アクションが実行されている[ランタイム環境の Docker イメージ](build-images.md)にアーティファクトをダウンロードし、ダウンロードしたファイルを使用して処理を完了します。
**注記**
現在、ワークフローアクション内で指定できるのは 1 つのソースリポジトリのみです。これは、ワークフロー定義ファイルが存在するソースリポジトリです (`.codecatalyst/workflows/` ディレクトリまたはそのサブディレクトリのいずれかの中)。このソースリポジトリには `WorkflowSource` というラベルが付きます。
------
#### [ Visual ]
**アクションで使用するソースリポジトリを指定するには (ビジュアルエディタ)**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトを選択します。
1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。
1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。
1. **[編集]** を選択します。
1. **[ビジュアル]** を選択します。
1. ワークフロー図で、ソースを指定するアクションを選択します。
1. **[入力]** を選択します。
1. **[ソース - 省略可]** で以下を実行します。
アクションに必要なソースリポジトリを表すラベルを指定します。現在、サポートされているラベルは `WorkflowSource` のみです。これは、ワークフロー定義ファイルが保存されているソースリポジトリを表します。
ソースを省略する場合は、`action-name/Inputs/Artifacts` で少なくとも 1 つの入力アーティファクトを指定する必要があります。
sources の詳細については、「[ワークフローへのソースリポジトリの接続](workflows-sources.md)」を参照してください。
1. (省略可) **[検証]** を選択して、ワークフローの YAML コードをコミットする前に検証します。
1. **[コミット]** を選択し、コミットメッセージを入力し、再度 **[コミット]** を選択します。
------
#### [ YAML ]
**アクションで使用するソースリポジトリを指定するには (YAML エディタ)**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクトを選択します。
1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。
1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。
1. **[編集]** を選択します。
1. **[YAML]** を選択します。
1. アクションで、次のようなコードを追加します。
```
action-name:
Inputs:
Sources:
- WorkflowSource
```
詳細については、アクションの「[ワークフロー YAML 定義](workflow-reference.md)」の `Sources` プロパティの説明を参照してください。
1. (省略可) **[検証]** を選択して、ワークフローの YAML コードをコミットする前に検証します。
1. **[コミット]** を選択し、コミットメッセージを入力し、再度 **[コミット]** を選択します。
------
# ソースリポジトリファイルの参照
ソースリポジトリにファイルがあり、ワークフローアクションのいずれかでこれらのファイルを参照する必要がある場合は、次の手順を実行します。
**注記**
[アーティファクト内のファイルの参照](workflows-working-artifacts-refer-files.md) も参照してください。
**ソースリポジトリに保存されているファイルを参照するには**
+ ファイルを参照するアクションで、次のようなコードを追加します。
```
Actions:
My-action:
Inputs:
Sources:
- WorkflowSource
Configuration:
Steps:
- run: cd my-app && cat file1.jar
```
前のコードでは、アクションが `WorkflowSource` ソースリポジトリのルートにある `my-app` ディレクトリを検索し、`file1.jar` ファイルを見つけて表示します。
# 「BranchName」変数と「CommitId」変数
CodeCatalyst ソースでは、ワークフローの実行時に `BranchName` 変数と `CommitId` 変数を生成および設定します。これらは*事前定義済み変数*と呼ばれます。これらの変数の詳細については、以下の表を参照してください。
ワークフローでこれらの変数を参照する方法については、「[事前定義済み変数の使用](workflows-using-predefined-variables.md)」を参照してください。
| キー | 値 |
| --- | --- |
| CommitId | ワークフロー実行開始時のリポジトリの状態を表すコミット ID。 例: `example3819261db00a3ab59468c8b` 「[例: 「CommitId」事前定義済み変数の参照](workflows-predefined-examples.md#workflows-working-with-variables-ex-refer-action)」も参照してください。 |
| BranchName | ワークフローの実行が開始されたブランチの名前。 例: `main`、`feature/branch`、`test-LiJuan` 「[例: 「BranchName」事前定義済み変数の参照](workflows-predefined-examples.md#workflows-working-with-variables-ex-branch)」も参照してください。 |