Qmonus Value Stream Docs

Appearance

2023-11-09 ​

Platform ​

Features: 機能追加や改善 ​

  • AssemblyLineの実行ログにおいて、エラーテキストが赤色でハイライトされるようになりました。

Fixes: 明確なバグフィックス ​

  • AssemblyLineの実行ログの表示時および、Report Logs取得時にタイムアウトする事象を解消しました。

CLI ​

  • qvsctl: v0.12.0

Features: 機能追加や改善 ​

  • qvsctl plugin gen-kubeconfig コマンドに -y/--yesフラグを追加しました。
    • フラグを指定することでファイル生成時に出力されるプロンプトにyesが入力されたものとして処理を継続します。

Official Cloud Native Adapter ​

  • qmonus.net/adapter/official: v0.18.0

Announce: 周知事項 ​

  • API Backend Adapterでアプリケーションに任意の引数、環境変数、シークレットを追加できるように改善しました。

    • 引数はQVS ConfigとDeployment Configを用いて下記のように設定してください。 QVS Config

      params:
  - name: args
    type: array

modules:
  ...

designPatterns:
- pattern: qmonus.net/adapter/official/adapters/azure/container/kubernetes/apiBackend
  params:
    args: ["$(params.args[*])"]

      Deployment Config

      args: "--foo,--bar"

    • 環境変数はQVS ConfigとDeployment Configを用いて下記のように設定してください。

      • 下記の例だと、ENV1=hoge, ENV2=fuga という値で環境変数が設定されます。 QVS Config
      params:
  - name: args
    type: array
  - name: env1
    type: string
  - name: env2
    type: string

modules:
  ...

designPatterns:
- pattern: qmonus.net/adapter/official/adapters/azure/container/kubernetes/apiBackend
  params:
    environmentVariables:
      ENV1: $(params.env1)
      ENV2: $(params.env2)

      Deployment Config

      env1: hoge
env2: fuga

    • シークレットを追加する際はQVS Config、および、Deployment Secretを用いて下記のように設定してください。

      • 下記の例だと、SECRET1, SECRET2という環境変数にExternal Secret Operator経由でDeployment Secretで登録したsecret1, secret2のシークレットがマウントされます。 QVS Config
      params:
  - name: secret1
    type: secret
  - name: secret2
    type: secret

modules:
  ...

designPatterns:
- pattern: qmonus.net/adapter/official/adapters/azure/container/kubernetes/apiBackend
  params:
    secrets:
      SECRET1: $(params.secret1)
      SECRET2: $(params.secret2)

      Deployment Secret

      • QVS Configをコンパイルし、Pipeline/Taskを適用後、secret1, secret2のキーをDeployment Secret画面から設定してください。

  • Shared Infrastructure Adapter(azure/container/kubernetes/apiBackend/sharedInfrastructure/) に、アプリケーションをデプロイするためのNamespaceとkubeconfigを生成する機能を追加しました。

    • 作成対象のNamespaceをappK8sNamespacesパラメータにカンマ区切りの文字列で指定してください。
    • appK8sNamespacesパラメータを指定しない場合は任意のNamespace作成は行われず、クラスターadmin権限を持つkubeconfigのみが作成されます。
    • kubeconfigの取得方法はドキュメントを参照してください。

Features: 機能追加や改善 ​

  • Simple Deploy by Pulumi Yaml Adapterを利用してリソースのデプロイを行う場合に、デプロイするリソースの一覧とデプロイ結果がログに出力されるようにしました。

    • 現時点で改善対象となるAdapterは以下になります。
    • 追加されたリソース一覧とデプロイ結果は以下のようにログに表示されます。
      • リソース一覧
      pulumi:providers:azure-native AzureProvider unchanged
azure-native:resources:ResourceGroup resourceGroup update
azure-native:network:VirtualNetwork virtualNetwork create
azure-native:network:VirtualNetwork virtualNetwork2 create
      • デプロイ結果
      pulumi:providers:azure-native AzureProvider unchanged
azure-native:resources:ResourceGroup resourceGroup updated
azure-native:network:VirtualNetwork virtualNetwork created
azure-native:network:VirtualNetwork virtualNetwork2 failed

  • API Backend Adapter (azure/container/kubernetes/apiBackend/) でアプリケーションに任意の引数、環境変数、シークレットを追加できるように改善しました。

  • Shared Infrastructure Adapter(azure/container/kubernetes/apiBackend/sharedInfrastructure/) に、アプリケーションをデプロイするためのNamespaceとkubeconfigを生成する機能を追加しました。

  • Frontend Adapterのドキュメントを加筆修正しました。

    • 静的Webアプリケーションをデプロイするユースケースのドキュメントを加筆修正しました。