メインコンテンツまでスキップ

Manage Applications

ZCP コンソールでは、アプリケーションの基本情報を管理できます。これには以下が含まれます：

  • アプリケーション名の管理
  • ビルド元のソースリポジトリの管理
  • ビルド後にデプロイするためのイメージレジストリの管理

アプリケーション検索画面からアプリケーション名を選択するか、アクションメニューの詳細ボタンをクリックしてアプリケーションの詳細を表示できます。

詳細画面は、概要、基本情報、ビルドパイプラインの3つのタブに整理されています。

Overview​

概要タブでは、アプリケーションのパイプラインのリストと各パイプラインに関する情報を表示できます。

Application Overview Screen Application Overview Screen

  • Name: パイプラインを識別するためのパイプライン名。

  • Branch: ビルドを実行する際にソースをチェックアウトするブランチの名前。

  • Tag Prefix: ビルド中に自動的にタグを生成する際にタグ名にプレフィックスとして付加されるプレフィックス名。自動タグ付けが「はい」に設定されている場合のみ有効です。

  • Last Created Image: このパイプラインが最後に実行されたときに作成されたイメージのURL。

  • Last Build: 最後のビルドが実行された時間。

  • Build Status: ビルドの結果。各アイコンはビルド成功、ビルド失敗、または実行中を意味します。

  • Actions: パイプラインに対してアクションを実行するためのボタン（履歴/ログの表示やビルドの実行など）。

Build an Application​

概要タブ画面では、アプリケーション内のパイプラインのリストが表示されます。ビルドしたいパイプラインの Actions のビルドアイコンをクリックすることでビルドを実行できます：

ビルドポップアップウィンドウでは、ビルドプロセスのログを表示できます。OKボタンをクリックすることでポップアップを閉じることができ、その時点でビルドはサーバー側で続行され、ビルドが完了するとビルド履歴が更新されます。

ビルドが実行中の間、Build Abortボタンをクリックすることでビルドを停止できます：

アプリケーションビルド履歴の表示​

概要タブ画面には、アプリケーション内のパイプラインのリストが表示されます。確認したいパイプラインのActionsにある履歴アイコンをクリックすることで、ビルド履歴を表示できます：

最後のビルドの実行履歴はカードUIで表示されます：

各項目の詳細は以下に示されています：

  1. ビルドの実行結果アイコン。状態は3つあります：ビルド成功、ビルド失敗、実行中。
  2. ビルド結果の概要。
    • Build No: ビルド番号。ビルド番号は、ビルドが実行されるたびに自動的に選択されます。各パイプラインには独自のビルド番号があります。括弧内の内容はビルド結果です。
    • Build Time: ビルドの開始時間と終了時間。右側にはビルドの全体の所要時間が表示されます。
    • Image: ビルド実行の結果であるイメージのURL。イメージレジストリ、プロジェクト、リポジトリ、タグ番号で構成されています。
    • Branch: ビルドを実行するために使用されたソースコードのブランチ名。
  • User ID: このビルドを実行したユーザーのID。
  1. ビルドログを表示するボタン。

ビルドパイプラインの実行フェーズは、タスク（親メニュー）とステップ（子メニュー）に構成されています。一般的に、タスクは三つのステージに分かれています: Source Checkout、Build、および Image Build & Push。パイプラインに特定のビルドツールが設定されていない場合、Source Checkout と Image Build & Push ステージのみが実行されます。各ステージをクリックすると、そのステージの実行ログを見ることができます。

アプリケーションビルドタスクフロー

ビルドログを表示​

これは、ビルドログを表示するボタンによって出力されるログ詳細画面です：

アプリケーションビルドログ詳細画面

  1. ビルド情報セクション。
  2. ビルドステップセクション。ビルドは三つの異なるステップに従って実行され、各ステップの選択に応じてそのステップのログが出力されます。
    • Result: ビルドの実行結果を表示します。ビルドが実行中の場合、スピナーが表示されます。
    • Source: ビルド時に使用されたソースコードのリポジトリURL。
    • Artifact: ビルドの出力に関する情報。これは、このビルドによって生成されるイメージのURLです。
  3. ログセクションは、実行中のビルドのログをリアルタイムで表示します。また、すでに実行が終了した過去のビルドのログも表示できます。
  4. OK ボタンをクリックして、ビルドログのポップアップ画面を閉じます。

アプリケーションパイプライン​

アプリケーションは複数のビルドパイプラインを作成でき、それぞれはビルドブランチ、ビルドツール、およびビルドオプションを指定することで構成できます。さらに、ビルド履歴の数を制限し、デプロイされるイメージのタグ付けを設定することができます。

  • Pipeline Name: パイプラインを識別するためのユーザー名。
  • Branch: パイプラインが実行されるときにソースがチェックアウトされるブランチの名前。1つのソースリポジトリ内で複数のブランチを構築でき、それぞれに別々のパイプラインがあります。たとえば、develop、staging、masterブランチを持つアプリケーションは、各ブランチに対して別々のパイプラインを持つことができます。
  • Build History: 管理するビルド履歴の数を設定します。
  • Build Tool: ビルド時に使用するビルドツールを選択します。サポートされているビルドツールはMaven、Gradle、NPMです。サポートされていないビルドツール（ant、yarnなど）を使用する必要がある場合は、ビルドツールのエントリをNoneに設定し、Dockerfile内でビルドを実行する必要があります。

    • Maven: Maven Configuration Screen

      • Jdk Version: ビルドするJDKのバージョンを指定します。
      • Maven Goals: Mavenコマンドを指定します。通常、アーティファクトを作成するためにpackageというゴールを使用します。
      • Mirror Url: 公共のMavenリポジトリに直接アクセスできない場合は、ミラーとして機能するNexusまたはArtifactoryを使用します。Mavenをビルドする際に使用するミラーのパスを指定できます。ミラーは公開されている必要があります（IDやパスワードなしでアクセス可能）。

    • Gradle: Gradle Configuration Screen

      • Jdk Version: ビルドするJDKのバージョンを指定します。
      • Gradle Task: Gradleでアーティファクトを生成するために使用するGradleタスクの名前。通常、buildNeededが使用され、Spring Bootアプリの場合はBootJarもよく使用されます。
  • Gradle Properties: ビルド時に使用されるプロパティの値を key=value 形式で指定します。また、gradle.properties ファイルの値を上書きするためにも使用されます。

    • Command line options: ビルドを実行する際に gradle コマンドに追加できるオプションを入力できます。

    • NPM: 入力がない場合はデフォルトでルートになります。 NPM 設定画面

      • Node Version: ビルドする Node のバージョンを指定します。
      • NPM task command exclude install: ビルド時に実行するタスクコマンドを指定します。インストールタスクは、以下のインストール Y/N によって決まります。
      • Remove cache Y/N: 前回のビルドから保存されたキャッシュと依存モジュールを削除するかどうかを決定します。
      • Install Y/N: npm install を実行するかどうかを決定します。
      • Context Path: NPM ビルドの基本スクリプトである package.json への相対パスを指定します。
    • None:
      • ビルドツールを None に指定すると、Dockerfile を使用してコンテナのみをビルドします。
  • Dockerfile Path: 画像をビルドする際に使用する Dockerfile へのパスを指定します。異なるパイプラインに対して異なる Dockerfile を使用できます。指定されていない場合は、基本情報で指定された Dockerfile が使用されます。基本情報で指定されていない場合は、ソースリポジトリのルートにある Dockerfile がデフォルトで使用されます。
  • Auto Tagging: 画像がビルドされる際に作成されるタグを自動的に生成するかどうかを設定します。Yes に設定すると、自動生成されたビルド番号がビルドが実行されるたびに画像のタグとして使用されます。Yes に設定されていない場合、ユーザーはビルドを実行するたびに手動で画像のタグを入力する必要があります。
  • Tag Prefix: 自動タグ付けを行う際に、タグ名にプレフィックスを指定します。この設定は、自動タグ付けが「はい」の場合にのみ必要です。たとえば、タグプレフィックスがdevの場合、タグ名は自動的にdev-1、dev-2として生成されます。…