外部の OCI 準拠レジストリの設定

外部の OCI 準拠レジストリを構成するには、cluster_config.json ファイルで以下のパラメーターを更新します。

キー	値 (Value)
registries.docker.url	既定値: registry.uipath.com コンテナー イメージをホストするために Automation Suite で使用するレジストリの URL または FQDN。
registries.docker.username registries.docker.password	レジストリから Docker イメージをプルするために使用する認証情報。 入力ファイルでいずれかの値が見つかった場合は、外部レジストリの構成時に両方の値を指定する必要があります。
registries.docker.pull_secret_value	レジストリのプル シークレット。 Automation Suite 2023.10.9 以降では、このフィールドは任意です。
registries.helm.url	既定値: registry.uipath.com サービスの Helm グラフをホストするために Automation Suite で使用される、レジストリの URL または FQDN です。
registries.helm.username registries.helm.password	レジストリから Helm グラフをプルするために使用する認証情報です。 入力ファイルでいずれかの値が見つかった場合は、外部レジストリの構成時に両方の値を指定する必要があります。
registries.trust.enabled	Connaisseur を有効または無効にします。 設定可能な値: true および false。
registries.trust.public_key	イメージの署名の検証に使用される Base64 エンコード形式の公開キー。既定では、Azure 資格情報レジストリ内のイメージへの署名に使用される秘密キーの公開部分に設定されています。
registries.trust.detection_mode	有効にすると、Connaisseur はイメージを検証できない場合にのみ警告を表示します。作成/更新要求はブロックされません。設定可能な値: true および false。
registry_ca_cert	レジストリ用に構成された証明書に対応する CA ファイルの場所。 オンプレミスでホストされているプライベート証明機関によってレジストリが署名されている場合は、信頼を確立するためにレジストリを提供する必要があります。

注:

Docker を使用する方法など、さまざまな方法を使用して、エンコードされたバージョンの pull_secret_valueを生成できます。詳しくは、「 外部レジストリ用にエンコードされたpull_secret_valueを生成する方法」をご覧ください。

次の構成サンプルは、一般的なOCI準拠のレジストリ設定を示しています:

{
    "registries": {
        "docker": {
            "url": "registry.domain.io",
            "username": "username",
            "password": "password", 
            "pull_secret_value": "pull-secret-value"
        },
        "helm": {
            "url": "registry.domain.io",
            "username": "username",
            "password": "password"
        },
        "trust": {
            "enabled": true,
            "public_key": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNE4vSzNzK2VXUTJHU3NnTTJNcUhsdEplVHlqRQp1UC9sd0dNTnNNUjhUZTI2Ui9TTlVqSVpIdnJKcEx3YmpDc0ZlZUI3L0xZaFFsQzlRdUU1WFhITDZ3PT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg==",
            "detection_mode": false
        }
    },
    "registry_ca_cert": "/etc/pki/ca-trust/extracted/ca-bundle.trust.crt"
}

プロジェクトの使用が必要な Harbor などのレジストリの場合は、レジストリ URL にプロジェクト名を追加する必要があります。この要件は、cluster_config.json ファイル内の registries.docker.url パラメーターと registries.helm.url パラメーターに適用されます。以下に例を示します。

{
    "registries": {
        "docker": {
            "url": "registry.domain.io/myproject",
            "username": "username",
            "password": "password",
            "pull_secret_value": "pull-secret-value"
        },
        "helm": {
            "url": "registry.domain.io/myproject",
            "username": "username",
            "password": "password"
        },
        "trust": {
            "enabled": true,
            "public_key": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNE4vSzNzK2VXUTJHU3NnTTJNcUhsdEplVHlqRQp1UC9sd0dNTnNNUjhUZTI2Ui9TTlVqSVpIdnJKcEx3YmpDc0ZlZUI3L0xZaFFsQzlRdUU1WFhITDZ3PT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg==",
            "detection_mode": false
        }
    },
    "registry_ca_cert": "/etc/pki/ca-trust/extracted/ca-bundle.trust.crt"
}