出力アーティファクトの定義 - Amazon CodeCatalyst

出力アーティファクトの定義

次の手順に従って、Amazon CodeCatalyst アクションで出力するアーティファクトを定義します。その後、このアーティファクトは他のアクションで使用できるようになります。

注記

すべてのアクションが出力アーティファクトをサポートしているわけではありません。アクションが出力アーティファクトをサポートしているかどうかを確認するには、以下のビジュアルエディタの手順を実行して、アクションの [出力] タブに [出力アーティファクト] ボタンが含まれているかどうかを確認します。含まれている場合は出力アーティファクトがサポートされています。

Visual
ビジュアルエディタを使用して出力アーティファクトを定義するには

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

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

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

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

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

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

  7. ワークフロー図で、アーティファクトを生成するアクションを選択します。

  8. [出力] タブを選択します。

  9. [アーティファクト] で [アーティファクトの追加] を選択します。

  10. [アーティファクトの追加] を選択し、次のようにフィールドに情報を入力します。

    アーティファクト名を構築

    アクションによって生成されるアーティファクトの名前を指定します。アーティファクト名はワークフロー内で一意でなければならず、英数字 (a～z、A～Z、0～9) とアンダースコア (_) しか使用できません。スペース、ハイフン (-)、その他の特殊文字は使用できません。引用符を使用して、出力アーティファクト名でスペース、ハイフン、その他の特殊文字を有効にすることはできません。

    アーティファクトの詳細 (例を含む) については、「アクション間でのアーティファクトとファイルの共有」を参照してください。

    構築で生成されるファイル

    CodeCatalyst がアクションによって出力されるアーティファクトに含めるファイルを指定します。これらのファイルは、実行時にワークフローアクションによって生成され、ソースリポジトリでも使用できます。ファイルパスは、ソースリポジトリまたは前のアクションからのアーティファクトに設定でき、ソースリポジトリまたはアーティファクトルートを基準とすることができます。glob パターンを使用してパスを指定できます。例:

    • ビルドまたはソースリポジトリの場所のルートにある 1 つのファイルを指定するには、my-file.jar を使用します。

    • サブディレクトリ内の 1 つのファイルを指定するには、directory/my-file.jar または directory/subdirectory/my-file.jar を使用します。

    • すべてのファイルを指定するには、"**/*" を使用します。glob パターン ** は、任意の数のサブディレクトリにマッチすることを示します。

    • directory という名前のディレクトリ内のすべてのファイルとディレクトリを指定するには、"directory/**/*" を使用します。glob パターン ** は、任意の数のサブディレクトリにマッチすることを示します。

    • directory という名前のディレクトリ内のすべてのファイルを指定するが、そのサブディレクトリを含めないようにするには、"directory/*" を使用します。

    注記

    ファイルパスに 1 つ以上のアスタリスク (*) またはその他の特殊文字が含まれている場合は、パスを二重引用符 ("") で囲みます。特殊文字の詳細については、「構文ガイドラインと規則」を参照してください。

    アーティファクトの詳細 (例を含む) については、「アクション間でのアーティファクトとファイルの共有」を参照してください。

    注記

    ファイルパスにプレフィックスを追加して、見つけるアーティファクトまたはソースを示す必要がある場合があります。詳細については、「ソースリポジトリファイルの参照」と「アーティファクト内のファイルの参照」を参照してください。

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

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

YAML
YAML エディタを使用して出力アーティファクトを定義するには

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

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

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

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

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

  6. [YAML] を選択します。

  7. ワークフローアクションで、次のようなコードを追加します。

    action-name:
  Outputs:
    Artifacts:
      - Name: artifact-name
        Files:
          - file-path-1
          - file-path-2

    その他の例については、「アーティファクトの例」を参照してください。詳細については、アクションの「ワークフロー YAML 定義」を参照してください。

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

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