ビルド アーティファクトの保存

以下のセクションに沿って、アーティファクトの操作方法を説明します。

• アーティファクトの概要
• アーティファクトのアップロード
• コア ファイルのアップロード
• CircleCI で行うビルドのすべてのアーティファクトのダウンロード

アーティファクトの概要

アーティファクトには、ジョブが完了した後もデータが維持され、ビルド プロセス出力を格納するストレージとして使用できます。

たとえば、Java のビルドおよびテストのプロセスが 1 つ終了すると、プロセスの出力が .jar ファイルとして保存されます。 CircleCI では、このファイルをアーティファクトとして保存し、プロセスの終了後も使用可能な状態に維持できます。

Another example of an artifact is a project that is packaged as an Android app where the .apk file is uploaded to Google Play.

ジョブによってスクリーンショット、カバレッジ レポート、コア ファイル、デプロイ ターボールなどの永続的アーティファクトが生成される場合、CircleCI はそれらを自動的に保存およびリンクします。

アーティファクトへのリンクは、[Job (ジョブ)] ページの [Artifacts (アーティファクト)] タブに表示されます。 アーティファクトは Amazon S3 に保存され、プライベート プロジェクト用の CircleCI アカウントを使用して保護されます。 curl ファイルのサイズは 3 GB に制限されています。

**アーティファクトへは作成から30日間アクセスできます。 ** ドキュメントや永続的なコンテンツのソースとして依存している場合、S3や静的Webサイト用のGitHub Pages、Netlifyのような専用領域にデプロイすることを推奨します。

メモ: アップロードされたアーティファクトのファイル名は、Java URLEncoder を使用してエンコードされます。 アプリケーション内の特定のパスにあるアーティファクトを探すときには、この点にご注意ください。

アーティファクトのアップロード

ビルド時に作成したアーティファクトをアップロードするには、以下の例を参考にしてください。

version: 2
jobs:
  build:
    docker:
      - image: python:3.6.3-jessie
        auth:
          username: mydockerhub-user
          password: $DOCKERHUB_PASSWORD  # context / project UI env-var reference

    working_directory: /tmp
    steps:

      - run:
          name: ダミー アーティファクトの作成
          command: |
            echo "my artifact file" > /tmp/artifact-1;
            mkdir /tmp/artifacts;
            echo "my artifact files in a dir" > /tmp/artifacts/artifact-2;

      - store_artifacts:
          path: /tmp/artifact-1
          destination: artifact-file

      - store_artifacts:
          path: /tmp/artifacts

この store_artifacts ステップによって、ファイル (/tmp/artifact-1) とディレクトリ (/tmp/artifacts) の 2 つのビルド アーティファクトがアップロードされます。 アップロードが正常に完了すると、ブラウザー内の[Job (ジョブ)] ページの [Artifacts (アーティファクト)] タブにアーティファクトが表示されます。 大量のアーティファクトをまとめてアップロードする場合は、単一の圧縮ファイルとしてアップロードすることで高速化できます。
単一のジョブで実行可能な store_artifacts ステップの数に制限はありません。

現在、store_artifacts には path と destination の 2 つのキーがあります。

• path は、アーティファクトとしてアップロードされるファイルまたはディレクトリのパスです。
• destination (オプション) は、アーティファクト API でアーティファクト パスに追加されるプレフィックスです。 path で指定されたファイルのディレクトリがデフォルトとして使用されます。

コア ファイルのアップロード

このセクションでは、コア ダンプを取得し、検査やデバッグで使用するためにアーティファクトとしてプッシュする方法について説明します。 以下の例では、abort(3) を実行してプログラムをクラッシュさせる短い C プログラムを作成します。

1. 以下の行を含む Makefile を作成します。

     all:
       gcc -o dump main.c
   

2. 以下の行を含む main.c ファイルを作成します。

     # <stdlib.h> を含めます
   
     int main(int argc, char **argv) {
         abort();
     }
   

3. 生成されたプログラムで make と ./dump を実行し、Aborted (core dumped) を印刷します。

このサンプル C abort プログラムをコンパイルし、コア ダンプをアーティファクトとして収集する config.yml の全体は、以下のようになります。

version: 2
jobs:
  build:
    docker:
      - image: gcc:8.1.0
        auth:
          username: mydockerhub-user
          password: $DOCKERHUB_PASSWORD  # context / project UI env-var reference
    working_directory: ~/work
    steps:
      - checkout
      - run: make
      - run: |
          # コア ダンプ ファイルのファイル サイズ制限をなくすようにオペレーティング システムに指示します
          ulimit -c unlimited
          ./dump
      - run:
          command: |
            mkdir -p /tmp/core_dumps
            cp core.* /tmp/core_dumps
          when: on_fail
      - store_artifacts:
          path: /tmp/core_dumps

ulimit -c unlimited は、コア ダンプ ファイルのファイル サイズ制限をなくします。 この制限をなくすと、プログラムがクラッシュするたびに、作業中のカレント ディレクトリにコア ダンプ ファイルが作成されます。 コア ダンプ ファイルには、core.%p.%E という名前が付きます。 %p はプロセス ID、%E は実行可能ファイルのパス名です。 詳細については、/proc/sys/kernel/core_pattern で仕様を確認してください。

curl を使用してアーティファクトをダウンロードするには、以下の手順を実行します。

CircleCI の API を使用してアーティファクトを操作する詳しい方法については、API リファレンス ガイド を参照してください。

CircleCI で行うビルドのすべてのアーティファクトのダウンロード

curl を使ってアーティファクトをダウンロードするには、以下の手順で行います。

1. パーソナル API トークンを作成し、クリップボードにコピーします。

2. ターミナル ウィンドウで、アーティファクトを保存するディレクトリに cd します。

3. 以下のコマンドを実行します。 : で始まる変数は、コマンドの下に掲載した表を参照して、実際の値に置き換えてください。

# Set an environment variable for your API token.
export CIRCLE_TOKEN=':your_token'

# `curl` gets all artifact details for a build 
# then, the result is piped into `grep` to extract the URLs.
# finally, `wget` is used to download the the artifacts to the current directory in your terminal.

curl -H "Circle-Token: $CIRCLE_TOKEN" https://circleci.com/api/v1.1/project/:vcs-type/:username/:project/$build_number/artifacts \
   | grep -o 'https://[^"]*' \
   | wget --verbose --header "Circle-Token: $CIRCLE_TOKEN" --input-file -

Similarly, if you want to download the latest artifacts of a build, replace the curl call with a URL that follows this scheme:

curl https://circleci.com/api/v1.1/project/:vcs-type/:username/:project/latest/artifacts?circle-token=:your_token

You can read more about using CircleCI’s API to interact with artifacts in our API reference guide.

関連項目

依存関係のキャッシュ

---

Help make this document better

This guide, as well as the rest of our docs, are open-source and available on GitHub. We welcome your contributions.

• Suggest an edit to this page (please read the contributing guide first).
• To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
• CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.

---

CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.