Qmonus Value Stream Docs

Appearance

初期セットアップ ​

ここでは、Qmonus Value Streamでデリバリパイプラインを設定・実行するための、初期セットアップを実施します。

Projectの作成 ​

WARNING

現在、Projectの作成機能は公開しておりません。新規に作成したい場合は、サポートサイトにて、お問合せください。

はじめに、Projectを作成します。 Projectは最上位のリソースであり、一つのProjectに複数のApplicationやEnvironmentを紐付けることができます。

  • 右上のユーザ名をクリックし、 Create Project を選択します。
  • 下記に従い、各フォームに入力します。
    • display nameを入力します。
    • 必要に応じて、Descriptionを入力します。
  • 設定内容が正しいことを確認し、Projectを作成します。
  • project作成後に自動リロードされた後、Project一覧に作成したProjectが表示されることを確認します。

Initial Setup Instruction

以降の作業は、画面右上の INITIAL SETUP に従い、1〜5 の設定を進めることで代替できます。

Applicationの設定 ​

Applicationを作成します。 Applicationには、アプリケーションコードを格納したGitリポジトリと、QVS Configの所在を設定します。

  1. 左メニューより、Applicationを選択します。
  2. 画面右上の NEW APPLICATION を選択します。
  3. 各フォームに以下の値を入力し、画面右下の NEXT ボタンを押下します。
    • Display Name: (Project内でユニークな任意の名前)
    • Description: (任意の文章または空白)
    • QVS Config Repository: + Create New Repositoryを選択し、Repositoryの登録手順に従いRepositoryを作成
    • QVS Config File Path: (QVS Configが格納されているディレクトリパス)

Repositoryの登録 ​

リリースしたいアプリケーションコードが格納されたリポジトリの情報を設定し、Repositoryを登録します。 各フォームに以下の値を入力し、画面右下のCREATEボタンを押下します。

  • Repository Kind: リポジトリプロバイダを選択
  • Git Clone Protocol: Git cloneの際に使用するプロトコルを選択 (https or ssh)
  • Repository Visibility: public または private
    • internalの場合はprivateを選択してください
  • Git Clone URL: リポジトリのURL
  • Description: (任意の文章または空白)
  • Git Token or Git SSH Key: Git Clone Protocolでの選択に応じてプライベートリポジトリに対し、認証するTokenもしくはSSH Keyを入力
    • TokenとSSH Keyは、当該リポジトリからpullできる権限を有している必要があります。

Deploymentの設定 ​

前項で作成したApplicationをリリースする先として、Deploymentを作成します。 リリース先の環境として使用するEnvironmentと、Environmentを構成する各Provisioning Targetにリクエストを送る際に使用するトークンなど機密情報を登録します。

各フォームに以下の値を入力し、画面右下の CREATE ボタンを押下します。

  • Display Name: (Application内でユニークな任意の名前)
  • Name: (Environment選択時に自動入力)
  • Environment: + Create New Environmentを選択し、Environmentの設定手順に従いEnvironmentを作成
  • Credentials: (リリースに必要な権限を有したアカウントのtokenやsecretを入力)

Environmentの設定 ​

Environmentを作成します。 作成したEnvironment設定は、後述するDeploymentにて、リリース先の環境を指定するために使用します。

各フォームに以下の値を入力し、画面右下のCREATEボタンを押下します。

  • Display Name: (任意の環境名)
  • Description: (任意の文章または空白)
  • Provisioning Target:
    • Kind:kubernetes　もしくは　gcp より選択
    • DisplayName,ProjectId : Provisioning Targetを一意に指定できるNameやID
    • Alias:（空白）
    • 同じタイプのProvisioning Targetを複数登録する際は、2つ目以降については Aliasのフォームに そのProvisioning Targetを特定できるエイリアス名を付与してください。