初めてのワークフロー - Amazon CodeCatalyst
前提条件ステップ 1: ワークフローの作成と構成ステップ 2: コミットを使用したワークフローの保存ステップ 3: 実行結果の表示（オプション）ステップ 4: クリーンアップする

Amazon CodeCatalyst は、2025 年 11 月 7 日以降、新規のお客様に公開されなくなります。サービスを使用する場合は、2025 年 11 月 7 日までにサインアップしてください。詳細については、「CodeCatalyst から移行する方法」を参照してください。

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

初めてのワークフロー

このチュートリアルでは、最初のワークフローを作成および構成する方法について説明します。

ヒント

事前構成済みワークフローから開始する場合は、「ブループリントを使用したプロジェクトの作成」を参照してください。機能するワークフロー、サンプルアプリケーション、およびその他のリソースを使用してプロジェクトを設定する手順が記載されています。

前提条件

開始する前に:

注記

既存のプロジェクトとソースリポジトリがある場合はそれらを使用できますが、新しいものを作成すると、このチュートリアルの最後にクリーンアップが容易になります。

ステップ 1: ワークフローの作成と構成

このステップでは、変更が行われたときにソースコードを自動的に構築してテストするワークフローの作成と構成を行います。

ワークフローを作成するには

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

  2. [ワークフローを作成] を選択します。

    CodeCatalyst コンソールの YAML エディタにワークフロー定義ファイルが表示されます。

ワークフローを構成するには

ワークフローは、ビジュアルエディタまたは YAML エディタで構成できます。まずは YAML エディタを使用し、その後ビジュアルエディタに切り替えましょう。

  1. [+ アクション] を選択すると、ワークフローに追加できるワークフローアクションのリストが表示されます。

  2. [ビルド] アクションで[+] を選択し、アクションの YAML をワークフロー定義ファイルに追加します。これでワークフローは次のようになります。

    Name: Workflow_fe47
SchemaVersion: "1.0"

# Optional - Set automatic triggers.
Triggers:
  - Type: Push
    Branches:
      - main

# Required - Define action configurations.
Actions:
  Build_f0:
    Identifier: aws/build@v1

    Inputs:
      Sources:
        - WorkflowSource # This specifies that the action requires this workflow as a source

    Outputs:
      AutoDiscoverReports:
        Enabled: true
        # Use as prefix for the report files
        ReportNamePrefix: rpt

    Configuration:
      Steps:
        - Run: echo "Hello, World!"
        - Run: echo "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>" >> report.xml
        - Run: echo "<testsuite tests=\"1\" name=\"TestAgentJunit\" >" >> report.xml
        - Run: echo "<testcase classname=\"TestAgentJunit\" name=\"Dummy
            Test\"/></testsuite>" >> report.xml

    ワークフローでは、Build_f0 アクションを実行しているコンピューティングマシンに WorkflowSource ソースリポジトリ内のファイルをコピーし、Hello, World! をログに出力し、コンピューティングマシン上のテストレポートを検出して、CodeCatalyst コンソールの [レポート] ページに出力します。

  3. [ビジュアル] を選択し、ビジュアルエディタでワークフロー定義ファイルを表示します。ビジュアルエディタのフィールドでは、YAML エディタに表示される YAML プロパティを構成できます。

ステップ 2: コミットを使用したワークフローの保存

このステップでは変更を保存します。ワークフローはリポジトリに .yaml ファイルとして保存されるため、コミットで変更を保存します。

ワークフローの変更をコミットするには

  1. (任意) [検証] を選択して、ワークフローの YAML コードが有効であることを確認します。

  2. [コミット] を選択します。

  3. [ワークフローファイル名] で、my-first-workflow などのワークフロー構成ファイルの名前を入力します。

  4. [コミットメッセージ] で、create my-first-workflow.yaml などのコミットを区別するメッセージを入力します。

  5. [リポジトリ] で、ワークフローを保存するリポジトリを選択します (codecatalyst-repository)。

  6. [ブランチ名] で、ワークフローを保存するブランチを選択します (main)。

  7. [コミット] を選択します。

新しいワークフローがワークフローのリストに表示されます。表示されるまでにしばらくかかることがあります。

ワークフローはコミットで保存され、ワークフローにはコードプッシュトリガーが構成されているため、ワークフローの保存によりワークフロー実行が自動的に開始されます。

ステップ 3: 実行結果の表示

このステップでは、コミットから開始された実行に移動し、結果を表示します。

実行結果を表示するには

  1. ワークフローの名前を選択します (例: Workflow_fe47)。

    ソースリポジトリのラベル (WorkflowSource) とビルドアクション (Build_f0 など) が表示されているワークフロー図。

  2. ワークフロー実行図で、ビルドアクション (Build_f0 など) を選択します。

  3. [ログ]、[レポート]、[構成]、[変数] の各タブの内容を確認します。これらのタブにはビルドアクションの結果が表示されます。

    詳細については、「ビルドアクションの結果の表示」を参照してください。

（オプション）ステップ 4: クリーンアップする

このステップでは、このチュートリアルで作成したリソースをクリーンアップします。

リソースを削除するには

  • このチュートリアル用に新しいプロジェクトを作成した場合は、削除します。手順については、「プロジェクトの削除」を参照してください。プロジェクトを削除すると、ソースリポジトリとワークフローも削除されます。