

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

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

# アクションの順序付け
<a name="workflows-depends-on"></a>

デフォルトでは、ワークフローにアクションを追加すると、[ビジュアルエディタ](workflow.md#workflow.editors)に横並びで追加されます。つまり、ワークフロー実行を開始すると、アクションが並行して実行されます。アクションを順番に実行する (ビジュアルエディタに縦方向に表示される) 場合は、アクション間に依存関係を設定する必要があります。例えば、ビルドアクションの後にテストアクションが実行されるように、`Build` アクションに依存する `Test` アクションを設定できます。

アクションとアクショングループ間の依存関係を設定できます。1 対多の依存関係を構成して、1 つのアクションの開始を他のいくつかのアクションに依存させることもできます。「[アクション間の依存関係の設定](workflows-depends-on-set-up.md)」のガイドラインを参照して、依存関係の設定がワークフローの YAML 構文に準拠していることを確認してください。

**Topics**
+ [アクション間の依存関係を構成する方法の例](workflows-depends-on-examples.md)
+ [アクション間の依存関係の設定](workflows-depends-on-set-up.md)

# アクション間の依存関係を構成する方法の例
<a name="workflows-depends-on-examples"></a>

次の例は、ワークフロー定義ファイル内のアクションとグループ間の依存関係を構成する方法を示したものです。

**Topics**
+ [例: 単純な依存関係の構成](#workflows-depends-on-example-simple)
+ [例: アクションに依存するようにアクショングループを構成する](#workflows-depends-on-example-action-groups-actions)
+ [例: 別のアクショングループに依存するようにアクショングループを構成する](#workflows-depends-on-example-two-action-groups)
+ [例: 複数のアクションに依存するようにアクショングループを構成する](#workflows-depends-on-example-advanced)

## 例: 単純な依存関係の構成
<a name="workflows-depends-on-example-simple"></a>

次の例は、`DependsOn` プロパティを使用して `Build` アクションに依存するように `Test` アクションを構成する方法を示したものです。

```
Actions:
  Build:
    Identifier: aws/build@v1
    Configuration:
      ...
  Test:
    DependsOn:
      - Build
    Identifier: aws/managed-test@v1
     Configuration:
       ...
```

## 例: アクションに依存するようにアクショングループを構成する
<a name="workflows-depends-on-example-action-groups-actions"></a>

次の例は、`FirstAction` アクションに依存するように `DeployGroup` アクショングループを構成する方法を示したものです。アクションとアクショングループが同じレベルにあることに注目してください。

```
Actions:
  FirstAction: #An action outside an action group
    Identifier: aws/github-actions-runner@v1
    Configuration:
      ...
  DeployGroup: #An action group containing two actions
    DependsOn: 
      - FirstAction
    Actions:
      DeployAction1:
      ...
      DeployAction2:
      ...
```

## 例: 別のアクショングループに依存するようにアクショングループを構成する
<a name="workflows-depends-on-example-two-action-groups"></a>

次の例は、`BuildAndTestGroup` アクショングループに依存するように `DeployGroup` アクショングループを構成する方法を示したものです。アクショングループが同じレベルにあることに注目してください。

```
Actions:
  BuildAndTestGroup: # Action group 1
    Actions:
      BuildAction:
      ...
      TestAction:
      ...
  DeployGroup: #Action group 2
    DependsOn: 
      - BuildAndTestGroup
    Actions:
      DeployAction1:
      ...
      DeployAction2:
      ...
```

## 例: 複数のアクションに依存するようにアクショングループを構成する
<a name="workflows-depends-on-example-advanced"></a>

次の例は、`FirstAction` アクションと `SecondAction` アクションに加え、`BuildAndTestGroup` アクショングループに依存するように `DeployGroup` アクショングループを構成する方法を示したものです。`DeployGroup` が `FirstAction`、`SecondAction`、`BuildAndTestGroup` と同じレベルにあることに注目してください。

```
Actions:
  FirstAction: #An action outside an action group
    ...
  SecondAction: #Another action 
    ...
  BuildAndTestGroup: #Action group 1
    Actions:
      Build:
      ...
      Test:
      ...
  DeployGroup: #Action group 2
    DependsOn: 
      - FirstAction
      - SecondAction
      - BuildAndTestGroup
    Actions:
      DeployAction1:
      ...
      DeployAction2:
      ...
```

# アクション間の依存関係の設定
<a name="workflows-depends-on-set-up"></a>

次の手順に従って、ワークフロー内のアクション間の依存関係を設定します。

依存関係を構成するときは、次のガイドラインに従ってください。
+ アクションがグループ内にある場合、そのアクションは同じグループ内の他のアクションにのみ依存できます。
+ アクションとアクショングループは、YAML 階層内で*同じレベル*の他のアクションとアクショングループに依存できますが、別のレベルでは依存*できません*。

------
#### [ Visual ]

**ビジュアルエディタを使用して依存関係を設定するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. プロジェクトを選択します。

1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。

1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。

1. **[編集]** を選択します。

1. **[ビジュアル]** を選択します。

1. ワークフロー図で、別のアクションに依存するアクションを選択します。

1. **[入力]** タブを選択します。

1. **[依存 - オプション]** で以下を実行します。

   このアクションを実行するために正常に実行する必要があるアクション、アクショングループ、またはゲートを指定します。

   「DependsOn」機能の詳細については、「[アクションの順序付け](workflows-depends-on.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:
     DependsOn:
       - action-1
   ```

   その他の例については、「[アクション間の依存関係を構成する方法の例](workflows-depends-on-examples.md)」を参照してください。一般的なガイドラインについては、「[アクション間の依存関係の設定](#workflows-depends-on-set-up)」を参照してください。詳細については、アクションの「[ワークフロー YAML 定義](workflow-reference.md)」の `DependsOn` プロパティの説明を参照してください。

1. (省略可) **[検証]** を選択して、ワークフローの YAML コードをコミットする前に検証します。

1. **[コミット]** を選択し、コミットメッセージを入力し、再度 **[コミット]** を選択します。

------