ローカルレジストリー・サポートを使用した Helmfile のインストール

システム要件およびコンポーネント

インストールを開始する前に、次のコンポーネントが使用可能であることを確認してください。

1.アーティファクトソース (HCL Harbor)

公式の HCL Harbor レジストリー (hclcr.io) は、ソースファイルをホストします。

• AppScan 360° Docker イメージ。

• Helm チャート (.tgz リリースとしてパッケージ化)

2.ターゲット環境 (カスタマーレジストリー)

プライベートレジストリーを使用できる必要があります (例: registry.customer.local/as360)。

• 要件: レジストリーは、OCI 機能を有効にする必要があります。

• 制限: 現在、レジストリーのルートへのアーティファクトのプッシュはサポートされていません。

3.Tooling

インストールバンドルには、次のツールが含まれています。

• Helmfile: コンポーネント (ASCP、ASRA、DTCS、SCA) の配置をオーケストレーションします。

• copy-artifacts.sh: イメージとチャートを HCL Harbor からローカルレジストリーにコピーするために、articlfactList ファイルから読み取るスクリプト。

4.資格情報

両方のレジストリーへの認証済みアクセス権があることを確認します。

• HCL Harbor: 読み取り専用資格情報。インストール手順

• 顧客レジストリー: 読み取り/書き込み資格情報。

インストール手順

ステップ 1: インストールバンドルを入手する

AppScan-360-Helm-Files
├── Copy Artifacts
│   ├── artifactList.txt        # List of images/charts 
to sync
│   ├── copy-artifacts.sh       # The synchronization 
script
├── Helm.d
│   ├── helmfile-ASCP.yaml.gotmpl
│   ├── helmfile-ASRA.yaml.gotmpl
│   ├── helmfile-SCA.yaml.gotmpl
│   ├── helmfile-DTSC.yaml.gotmpl
│   └── helmFileCustomization
│       └── singular-singular.clusterKit-Sample.yaml  # 
Main config file
├── helmfile.yaml.gotmpl

└── README.md

ステップ 2: アーティファクトをローカルレジストリーに同期させる

プライベートレジストリー (オフライン/分離モード) を使用している場合は、まず HCL Harbor から必要なファイルをコピーする必要があります。

./copy-artifacts.sh

スクリプト入力:

1. 宛先レジストリー: レジストリーの URL とリポジトリーを入力します (例: registry.customer.local/as360)。

2. アーティファクトリスト: スクリプトは、imalist ファイル ([IMAGES] セクションと [HELM] セクションを含む) を自動的に読み取ります。

成功: このステップにより、すべての Docker イメージと Helm チャートが環境に確実にミラーリングされます。

ステップ 3: レジストリーオーバーライドを構成する

HCL Harbor ではなくローカルレジストリーを参照するように Helmfile に指示するには、構成ファイルを更新する必要があります。

1. helmFileCustomization/singular-singular.clusterKit-Sample.yaml を開きます。

2. 単一ファイルセクションを探します。

3. レジストリーおよびリポジトリフィールドをローカルの詳細情報で更新します。

helm:
  package:
     registry: 'registry.customer.local'
     context: 'as360/charts'
workload:
  affiliatedSidecarsProject: appscan360
  container:
    image:
      registry: 'registry.customer.local'
      repository: 'as360/images'
      pullPolicy: IfNotPresent

その仕組み:

• プライマリーロジック: このカスタマイズファイルからレジストリーの詳細が読み取られます。

• フォールバックロジック: これらの詳細情報が欠落している場合、またはファイルが構成されていない場合、デフォルトでは HCL Harbor から直接取得されます (既存のお客様が構成を移行する場合に役立ちます)。

ステップ 4: インストールの実行

アーティファクトが同期され、構成が更新されたら、配置を実行します。

インストールディレクトリーのルートから次のコマンドを実行します。

helmfile sync

次に発生する状況

Helmfile は、カスタマイズファイルを読み取り、指定したローカルレジストリーのイメージとグラフを使用して ASCP、ASRA、DTSC、および SCA を配置イします。

ソフトウェア・コンポジション分析 (SCA) を含める

includeSCA=true helmfile sync

includeSCA=true helmfile destroy

export SCA_AUTOUPDATER_REGISTRY_USERNAME=<HCL_HARBOR_USERNAME>
export SCA_AUTOUPDATER_REGISTRY_PASSWORD=<HCL_HARBOR_PASSWORD>