Skip to main content

ビットライズで自分だけのDockerイメージを構築しよう

概要

独自のDockerイメージを作成し、Bitriseのビルド中にコンテナーレジストリーにプッシュすることができます Docker ビルド & プッシュステップ

独自のDockerイメージを作成し、Bitriseのビルド中にコンテナーレジストリーにプッシュすることができます Docker ビルド & プッシュステップ

このステップでは docker build コマンド: 必要な Docker file これにはビルド手順とビルドコンテキストが含まれています。ビルドコンテキストとは、指定されたパスにあるファイルのセットです。このステップでは合格できます オプション引数を構築する ビルドへ。

ビルドをスピードアップするために、このステップでは以下の機能もサポートしています キーベースのキャッシュ

ビルドオプションを使用してイメージをビルドするには、ビルド引数とキャッシュを使用します。

ワークフローエディター

bitrise.yml

  1. を追加 Docker ビルド & プッシュ ワークフローへのステップ。

  2. ステップに必要な入力を設定します。

    • 画像タグ: ビルドイメージの名前に適用されるタグのリスト。1 行に 1 つのタグを追加できます。画像タグ、その機能、必要な形式について詳しくは、以下をご覧ください Docker ドキュメンテーション

    • コンテキストパスを作成: ビルドコンテキストを構成するファイルへのパス。Bitrise の作業ディレクトリからの相対パスでなければなりません

    • ドッカーファイルパス: 使用したい Docker ファイルへのパス。Bitrise の作業ディレクトリからの相対パスでなければなりません

  3. ビルドしたイメージをコンテナーレジストリーにプッシュする場合は、次のように設定します。 Docker イメージをプッシュする への入力 true

  4. イメージをキャッシュするには、以下を設定します Bitrise のキーバリューキャッシュを使う への入力 true

    入力は次のキャッシュキーを使用します。

    • docker-imagename-{{ .OS }}-{{ .Arch }}-{{ .Branch }}-{{ .CommitHash }}

    • docker-imagename-{{ .OS }}-{{ .Arch }}-{{ .Branch }}

    • docker-imagename-{{ .OS }}-{{ .Arch }}

    代替キャッシュ方法

    このステップは、を使用したキャッシュもサポートしています --cache-from--cache-to のオプション docker build コマンド。ザ・ 引数からのキャッシュ引数にキャッシュ 入力がこの機能を提供します。

    キーベースのキャッシュを使用する場合は、これらの入力を使用しないでください!空欄のままにしておきます

  5. オプションで、ビルド引数とオプションを使用してビルドコマンドをカスタマイズします。

    • 追加 引数をビルド引数を構築 入力:a の 1 行に 1 つの引数 MY_ARG=my_value フォーマット。

    • 追加 オプション追加オプション 入力:1 行に 1 つの追加オプション (次の形式)--option valueまたは--option=value

      引用符付きの値

      引用符で囲まれた値を使用する場合 (たとえば、値にスペースが含まれている場合) は、等号を使用しないでください。代わりにスペースで区切ってください。 --option "value with spaces"

  1. を追加 docker-build-push ワークフローにステップアップ。

  2. ステップに必要な入力を設定します。

    • tags: ビルドイメージの名前に適用されるタグのリスト。1 行に 1 つのタグを追加できます。画像タグ、その機能、必要な形式について詳しくは、以下をご覧ください Docker ドキュメンテーション

    • context: ビルドコンテキストを構成するファイルへのパス。Bitrise の作業ディレクトリからの相対パスでなければなりません

    • file: 使用したい Dockerfile へのパス。Bitrise の作業ディレクトリからの相対パスでなければなりません

    workflow:
      steps:
        - docker-build-push:
            inputs:
            - tags: myregistry.com/myimage:latest
            - context: "./path"
            - file: "./Dockerfile"
    
  3. ビルドしたイメージをコンテナーレジストリーにプッシュする場合は、次のように設定します。 push への入力 true

    workflow:
      steps:
        - docker-build-push:
            inputs:
            - tags: myregistry.com/myimage:latest
            - context: "./path"
            - file: "./Dockerfile"
            - push: "true"
  4. イメージをキャッシュするには、以下を設定します use_bitrise_cache への入力 true

    入力は次のキャッシュキーを使用します。

    • docker-imagename-{{ .OS }}-{{ .Arch }}-{{ .Branch }}-{{ .CommitHash }}

    • docker-imagename-{{ .OS }}-{{ .Arch }}-{{ .Branch }}

    • docker-imagename-{{ .OS }}-{{ .Arch }}

    代替キャッシュ方法

    このステップは、を使用したキャッシュもサポートしています --cache-from--cache-to のオプション docker build コマンド。ザ・ cache_fromcache_to 入力がこの機能を提供します。

    キーベースのキャッシュを使用する場合は、これらの入力を使用しないでください!空欄のままにしておきます

    workflow:
      steps:
        - docker-build-push:
            inputs:
            - tags: myregistry.com/myimage:latest
            - context: "./path"
            - file: "./Dockerfile"
            - push: "true"
            - use_bitrise_cache: "true"
  5. オプションで、ビルド引数とオプションを使用してビルドコマンドをカスタマイズします。

    • 追加 引数をビルドbuild_arg 入力:a の 1 行につき 1 つの引数 MY_ARG=my_value フォーマット。

    • 追加 オプションextra_options 入力:1 行に 1 つの追加オプションを、次の形式で--option valueまたは--option=value

      引用符付きの値

      引用符で囲まれた値を使用する場合 (たとえば、値にスペースが含まれている場合) は、等号を使用しないでください。代わりにスペースで区切ってください。 --option "value with spaces"

    workflow:
      steps:
        - docker-build-push:
            inputs:
            - tags: myregistry.com/myimage:latest
            - context: "./path"
            - file: "./Dockerfile"
            - push: "true"
            - use_bitrise_cache: "true"
            - build_arg: BUILD_ARG=my_value
            - extra_options: "--option value"