ローカル・ディレクトリーからソースをプルするビルド構成を作成します

ソースがローカル・ワークステーション上にある場合は、ローカル・ディレクトリーからソースをプルする場所に関する情報を含む設定を使用してビルド構成を作成します。 ビルド出力については、レジストリーの詳細を指定するか、 Code Engine に IBM Cloud Container Registry の詳細を管理させることができます。

Code Engine CLI のみを使用して、ローカル・ディレクトリーからソースをプルするビルド構成を作成できます。

ローカル・ディレクトリーからコードをプルするビルドを実行依頼すると、ソース・コードがアーカイブ・ファイルにパックされ、IBM Cloud Container Registryインスタンスにアップロードされます。 ローカル・ビルドのIBM Cloud Container Registryのみをターゲットにすることができます。 ソース・イメージは、ビルド・イメージと同じ名前空間に作成されます。

.ceignore ファイルを使用して、ソース・コード内の特定のファイル・パターンを無視することができます。このファイルは、 .gitignore ファイルと同様に動作します。 例えば、node.js アプリケーションの.ceignoreファイルのエントリーには、node_modulesおよび.npmが含まれる場合があります。 無視するその他のサンプル・ファイル・パターンについては、 GitHub.gitignore リポジトリーを参照してください。

ビルド構成を作成してもイメージは作成されませんが、イメージをビルドするための構成が作成されます。 イメージを作成するには、ビルド構成を参照するビルドを実行する必要があります。 ビルドを実行するまでは、ビルド構成が検証されることも、イメージを作成するために使用されることもありません。 ビルド構成を使用すると、特定のイメージの複数のビルドを後で作成することができます。これはソース・リポジトリーに変更が適用された場合などに便利です。

CLI を使用してローカル・ディレクトリーからコードをプルするビルド構成を作成するには、**build create**コマンドを使用し、build-typeをlocalとして指定します。 オプションの全リストについては、ibmcloud ce build create コマンドを参照してください。

build create コマンドを使用すると、 Code Engine でソースからイメージを作成し、そのイメージを IBM Cloud Container Registryに保管できます。 この 自動アクセス の場合、レジストリー・シークレットやイメージ・レジストリーの場所を指定する必要はありません。 あるいは、 Code Engine がビルド結果にアクセスしてレジストリーにプッシュできるように、ビルド・イメージ出力の場所を指定し、レジストリー・シークレットを指定することができます。

CLI を使用したビルド構成の作成 (ローカル・ソースおよびレジストリーへの自動アクセスを使用)

このシナリオでは、Code Engine はローカル・ソースからイメージを作成し、そのイメージを IBM Cloud Container Registry に自動的にアップロードします。 Container Registry で Code Engine がこれらのイメージに自動的にアクセスするために必要な許可の設定について詳しくは、イメージ・レジストリーの権限のセットアップを参照してください。

開始前に

ビルド構成を作成して、ローカル・ワークステーション上のソースからイメージをビルドし、Code Engine が自動的にイメージを保管してアクセスできるようにします。 -build-typeの値としてlocalを指定した場合、ローカル・ビルドの出力のターゲットとして IBM Cloud Container Registry のみを指定できます。 この例では、コマンドはデフォルトのdockerfile戦略と、デフォルトのmediumビルド・サイズを使用します。 イメージ・レジストリーまたはレジストリー・シークレットの場所を指定しないことにより、 Code Engine は、自動アクセスを使用してビルド出力を IBM Cloud Container Registry にプッシュします。

ibmcloud ce build create --name build-local-dockerfile --build-type local

ビルド構成を作成した後、 ビルドを実行 してイメージ・ファイルを作成する必要があります。 イメージ・ファイルが作成されたら、新しく作成したイメージ・ファイルを使用して アプリをデプロイ したり、 ジョブを実行 したりすることができます。

CLI を使用したビルド構成の作成 (ローカル・ソースおよびユーザー提供のレジストリーへのアクセス権限を使用)

このシナリオでは、Code Engine はローカル・ソースからイメージを作成し、提供されたレジストリー・アクセス権限を使用してイメージをコンテナー・レジストリーにアップロードします。

開始前に

ローカル・ワークステーション上のソースからイメージをビルドするためのビルド構成を作成し、レジストリー・シークレットを使用してビルド出力のイメージ・レジストリーの場所を指定します。 **build create**コマンドを使用する場合、--build-typeの値としてlocalを指定すると、ローカル・ビルドの出力のターゲットとして IBM Cloud Container Registry のみを指定できます。 イメージ・レジストリーの場所を指定するには--imageオプションを指定し、レジストリーにアクセスするには--registry-secretオプションを指定します。 この例では、コマンドはデフォルトのdockerfile戦略と、デフォルトのmediumビルド・サイズを使用します。

ibmcloud ce build create --name build-local-dockerfile --build-type local --image us.icr.io/mynamespace/codeengine-build --registry-secret myregistry

ビルド構成を作成した後、 ビルドを実行 してイメージ・ファイルを作成する必要があります。 イメージ・ファイルが作成されたら、新しく作成したイメージ・ファイルを使用して アプリをデプロイ したり、 ジョブを実行 したりすることができます。