機械翻訳について

デフォルトの構成ファイルのオプション

Oracle CNE CLIのデフォルト構成ファイルに含めることができるオプションをリストします。

デフォルトの構成ファイルはYAML形式で、$HOME/.ocne/defaults.yamlに保存する必要があります。 ファイルには、次のいずれかのオプションを含めることができます:

autoStartUI

クラスタのインスタンス化時にOracle CNE UIサービスへのトンネルを作成するかどうかを設定し、デフォルトのブラウザを起動してUIをロードします。 たとえば: 

autoStartUI: true
bootVolumeContainerImage

Oracle Container Host for Kubernetes (OCK)ブート可能イメージを含むコンテナ・イメージ・レジストリおよびタグ。 デフォルトはcontainer-registry.oracle.com/olcne/ockです:1.32. たとえば: 

bootVolumeContainerImage: container-registry.oracle.com/olcne/ock:1.32
clusterDefinition

クラスタ構成ファイルへのパス。 このデフォルト構成ファイルで指定されていない複雑な構成を使用するクラスタに対して、この追加の構成レイヤーを指定します。 たとえば: 

clusterDefinition: mycluster.yaml
clusterDefinitionInline

インライン構成オプションを指定します。 このデフォルト構成ファイルで指定されていない複雑な構成を使用するクラスタに対して、この追加の構成レイヤーを指定します。 このオプションはclusterDefinitionとともに使用できません。 たとえば: 

clusterDefinitionInline: |
  key1: value1
  key2: value2
cni

クラスタのインスタンス化時にインストールするコンテナ・ネットワーキング・インタフェース(CNI)プロバイダ。 値は、Oracle CNEで使用可能な任意のCNI、または別のCNIを手動またはアプリケーション・カタログを使用してデプロイする場合はnoneです。

ノート:

MultusはプライマリCNIとして使用できません。 Multusは、デフォルトのアプリケーション・カタログでアプリケーションとして使用できます。 Multusアプリケーションをインストールする場合は、このオプションをnoneに設定します。

たとえば:

cni: flannel
cni: none
communityCatalog

アーティファクト・ハブ・アプリケーション・カタログがインストールされているかどうかを設定します。 これをtrueに設定すると、カタログがインストールされます。 これをfalseに設定すると、カタログはインストールされません。 デフォルトはfalseです。 たとえば: 

communityCatalog: true
ephemeralCluster

ホスト・システムで完了できないタスクを実行するために生成される可能性のある短期間のクラスタをカスタマイズできます。 これは、ブートOCKイメージの変更またはKubernetesクラスタAPIリソースのデプロイによく使用されます。 使用できるオプションは次のとおりです:

name

クラスタの名前。 たとえば: 

ephemeralCluster:
  name: mycluster
preserve

作業の完了後にエフェメラル・クラスタを自動的に削除するかどうかを設定します。 デフォルトはfalseであるため、エフェメラル・クラスタは使用後に削除されます。 たとえば: 

ephemeralCluster:
  preserve: true
node

VMsの構成を設定します。 たとえば: 

ephemeralCluster:
  node:
    cpus: 2
    memory: 4GB
    storage: 15GB
extraIgnition

クラスタの作成時またはクラスタへのノードの結合時に含める追加のIgnition情報を含むIgnitionファイルへのパス。 Ignition情報は、「アップストリームIgnitionのドキュメント」に記載されているIgnition仕様v3.4.0に準拠し、Butane Fedora CoreOS仕様v1.5.0を使用してYAMLに記述する必要があります(「アップストリームButaneドキュメント」を参照)。 たとえば: 

extraIgnition: /home/username/.ocne/ignition.ign
extraIgnitionInline

クラスタの作成時またはクラスタへのノードの結合時に含める追加のイグニッション情報。 Ignition情報は、「アップストリームIgnitionのドキュメント」に記載されているIgnition仕様v3.4.0に準拠し、Butane Fedora CoreOS仕様v1.5.0を使用してYAMLに記述する必要があります(「アップストリームButaneドキュメント」を参照)。 形式は次のとおりです: 

extraIgnitionInline: |
  key1: value1
  key2: value2
  ...
headless

Oracle CNE UIをインストールするかどうかを設定します。 これがtrueに設定されている場合、UIはインストールされません。 デフォルトはfalseです。 たとえば: 

headless: true
kubeApiServerBindPort

Kubernetes APIサーバーが公開されるポートを設定します。 デフォルトは6443です。 たとえば: 

kubeApiServerBindPort: 6443
kubeApiServerBindPortAlt

KeepalivedおよびNGINXロード・バランサを使用して高可用性クラスタをデプロイするときに、Kubernetes APIサーバーがリスニングするポートを設定します。 デフォルトは6444です。 たとえば: 

kubeApiServerBindPortAlt: 6444
kubeconfig

実行中のクラスタを必要とする操作に使用するkubeconfigファイルへのパス。 たとえば: 

kubeconfig: /home/username/.kube/kubeconfig.utilitycluster
kubeProxyMode

kube-proxyのモード。 これは、iptablesまたはipvsに設定できます。 デフォルトはiptablesです。 たとえば: 

kubeProxyMode: ipvs

kube-proxyモードの詳細は、「アップストリームのKubernetesドキュメント」を参照してください。

kubernetesVersion

これにより、Kubernetesバージョンが定義されます。 デフォルトは最新バージョンです。 たとえば: 

kubernetesVersion: 1.32
osRegistry

osTagと組み合せると、コンテナ・レジストリ内のOSTreeイメージが識別されます。 OSTreeトランスポートおよびコンテナ・レジストリURIを指定します。

トランスポートに使用できるプレフィクスは次のとおりです:

ostree-image-signed
ostree-remote-image
ostree-unverified-image
ostree-unverified-registry

デフォルト値は次のとおりです。

osRegistry: ostree-unverified-registry:container-registry.oracle.com/olcne/ock-ostree
osTag

osRegistryと組み合せると、コンテナ・レジストリ内のOSTreeイメージが識別されます。 イメージのタグを指定します。 たとえば: 

osTag: 1.32
password

クラスタ・ノードによる認証を行うOCKイメージ・ユーザー(ocne)のハッシュ・パスワード。 たとえば: 

password: $6$jfkldjfsd$n1YMnpdxlGXO...

パスワードを引用符で囲むことはオプションです。

opensslユーティリティを使用して、ハッシュ・パスワードを作成できます。 たとえば、SHA512アルゴリズムと自動saltを使用してハッシュ・パスワードを生成するには: 

openssl passwd -6 -salt password

指定されたsaltフレーズを使用してSHA512ハッシュ・パスワードを生成するには:

openssl passwd -6 -salt saltphrase password
podSubnet

ポッド・ネットワークに使用するサブネット。 CNIは、このサブネットを使用するように自動的に構成されます。 たとえば: 

podSubnet: 10.244.0.0/16
providers

プロバイダ構成オプションを指定します。 たとえば: 

providers:
  byo: 
    options
  libvirt:
    options
  none:
    options
  oci:
    options
  olvm:
    options

各プロバイダのオプションを次に示します:

proxy

プロキシ・サーバー情報。 この情報は、Kubernetesノードで構成されます。 たとえば: 

proxy:
  httpsProxy: http://myproxy.example.com:2138
  httpProxy: http://myproxy.example.com:2138
  noProxy: .example.com,127.0.0.1,localhost,169.254.169.254,10.96.0.0/12,10.244.0.0/16
quiet

ocneコマンドで出力されるメッセージを減らすかどうかを設定します。 これがtrueに設定されている場合、メッセージは削減されます。 falseに設定すると、メッセージは削減されません。 デフォルトはfalseです。 たとえば: 

quiet: true
registry

コンテナ・イメージのプロビジョニング元のレジストリを設定します。 デフォルトはcontainer-registry.oracle.comです。 たとえば: 

registry: myregistry.example.com
serviceSubnet

サービス・ネットワークに使用するサブネット。 デフォルトは10.96.0.0/12です。 たとえば: 

serviceSubnet: 10.96.0.0/12
sshPublicKey

OCKイメージ・ユーザー(ocne)のRSAキー・ペアの公開キー。 公開キー・ファイルの内容を貼り付けます。

たとえば:

sshPublicKey: | 
    ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA...
sshPublicKeyPath

クラスタ・ノードによる認証を行うOCKイメージ・ユーザー(ocne)のRSAキー・ペアの公開キーへのパス。 

sshPublicKeyPath: /home/username/.ssh/id_rsa.ocne

独自の持込みプロバイダ・オプション

byoプロバイダのオプションは次のとおりです:

automaticTokenCreation

trueに設定した場合、結合トークンが必要なときはいつでも、コマンドの一部として自動的に作成されます。 falseに設定されている場合は、トークンを手動で作成する必要があります。 たとえば: 

providers:
  byo:
    automaticTokenCreation: false
networkInterface

CNIおよび他のKubernetesサービスがバインドするネットワーク・インタフェースを設定します。 このオプションは必須です。 たとえば: 

providers:
  byo:
    networkInterface: enp1s0

libvirtプロバイダ・オプション

libvirtプロバイダのオプションは次のとおりです:

controlPlaneNode

コントロール・プレーン・ノードの構成オプションを設定します。 サイズを指定するには、次を使用します:

  • M: メガバイト

  • G: ギガバイト

  • Mi: メビバイト

  • Gi: ギビバイト

たとえば: 
providers:
  libvirt:
    controlPlaneNode:
      cpu: 2
      memory: 16Gi
      storage: 8Gi
network

ドメインに使用する仮想ネットワークの名前。 たとえば: 

providers:
  libvirt:
    network: bridge-1
sshKey

SSH接続に使用するSSHキーへのパス。 たとえば: 

providers:
  libvirt:
    sshKey: /home/username/.ssh/id_rsa.ocne
storagePool

OCKイメージに使用するストレージ・プールの名前。 たとえば: 

providers:
  libvirt:
    storagePool: mypool
uri

libvirt接続URIのデフォルト値。 たとえば、ローカル接続の場合: 

providers:
  libvirt:
    uri: qemu:///system

リモート接続の場合:

providers:
  libvirt:
    uri: qemu+ssh://user@host/system
workerNode

ワーカー・ノードの構成オプションを設定します。 サイズを指定するには、次を使用します:

  • M: メガバイト

  • G: ギガバイト

  • Mi: メビバイト

  • Gi: ギビバイト

たとえば: 
providers:
  libvirt:
    workerNode:
      cpu: 2
      memory: 16Gi
      storage: 8Gi

OCI プロバイダ・オプション

ociプロバイダのオプションは次のとおりです:

compartment

リソースをデプロイするOCIコンパートメント。 これは、コンパートメントへのパス(mytenancy/mycompartmentなど)またはコンパートメントのOCIDのいずれかです。 たとえば: 

providers:
  oci:
    compartment: OCID
controlPlaneShape

コントロール・プレーン・ノードの作成時にコンピュート・インスタンスに使用するシェイプの名前。 たとえば: 

providers:
  oci:
    controlPlaneShape:
      shape: VM.Standard.E4.Flex
      ocpus: 2
imageBucket

OCIオブジェクト・ストレージにアップロードされるときにOCKブート・イメージを格納するために使用するバケットのOCIDまたは名前。 デフォルト名はocne-imagesです。 たとえば: 

providers:
  oci:
    imageBucket: ocne-images
images

コンピュート・リソースの初期ディスク・イメージとして使用するOCKイメージのOCI OCIDs。 amd64およびarm64アーキテクチャのオプションを設定します。 たとえば: 

providers:
  oci:
    images:
      amd64: OCID
      arm64: OCID
kubeconfig

ターゲット管理クラスタに使用するkubeconfigファイルへのパス。 たとえば: 

providers:
  oci:
    kubeconfig: /home/username/.kube/kubeconfig.mgmtcluster
loadBalancer

OCIロード・バランサをデフォルト・デプロイメント用にプロビジョニングする際に使用するサブネットのOCIDs。 たとえば: 

providers:
  oci:
    loadBalancer:
      subnet1: OCID
      subnet2: OCID
namespace

KubernetesクラスタAPIリソースがデプロイされるKubernetesネームスペース。

providers:
  oci:
    namespace: mynamespace
selfManaged

クラスタが自己管理であるかどうかを設定します。 trueに設定すると、クラスタには、独自のライフ・サイクルを管理するために必要なコントローラおよびリソースが含まれます。 falseに設定するか、または設定しない場合、これらのリソースは初期管理クラスタに残ります。 たとえば: 

providers:
  oci:
    selfManaged: true
profile

使用するOCI CLIプロファイルを設定します。 これは、OCI CLI構成ファイル内のプロファイルの名前です。 デフォルトのプロファイルはDEFAULTです。 たとえば: 

providers:
  oci:
    profile: MYTENANCY
vcn

デフォルト・デプロイメントのロード・バランサの作成時に使用するVirtual Cloud NetworkのOCID。

providers:
  oci:
    vcn: OCID
workerShape

ワーカー・ノードの作成時にコンピュート・インスタンスに使用するシェイプの名前。 たとえば: 

providers:
  oci:
    workerShape:
      shape: VM.Standard.E4.Flex
      ocpus: 2

Oracle Linux Virtualization Managerプロバイダ・オプション

olvmプロバイダのオプションは次のとおりです:

controlPlaneMachine

コントロール・プレーンVMノードのオプションを設定します。 オプションは次のとおりです。

olvmNetwork: VMのネットワーク設定:

  • networkName: Oracle Linux Virtualization Managerネットワーク名。 これは、Oracle Linux Virtualization Managerインスタンスに存在する必要があります。

  • vnicName: Oracle Linux Virtualization Manager VNIC名。 これはオプションです。

  • vnicProfileName: Oracle Linux Virtualization Manager VNICプロファイル名。 これは、Oracle Linux Virtualization Managerインスタンスに存在する必要があります。

olvmOvirtClusterName: Oracle Linux Virtualization Managerクラスタの名前。 これはデータ・センターに存在する必要があります。

virtualMachine: VMsのオプションを設定します。 オプションは次のとおりです。

  • cpu: CPUに関する情報。 オプションは次のとおりです。

    • topology:

      • architecture: CPUのアーキテクチャ。 デフォルトはx86_64です。

      • cores: コアの数。 デフォルトは2です。

      • sockets: ソケットの数。 デフォルトは2です。

      • threads: スレッドの数。 デフォルトは1です。

  • memory: VMsのメモリーのサイズ。 デフォルトは7GBです。

  • network: VMのネットワーク・オプションを設定します。 オプションは次のとおりです。

    • gateway: VMのネットワーク・ゲートウェイのIPアドレス。

    • interface: VMsのネットワーク・インタフェース名。 これはオプションです。 デフォルトはenp1s0です。

    • interfaceType: VMsのネットワーク・インタフェース・タイプ。 これはオプションです。 デフォルトはvirtioです。

    • ipv4: VMsのIPv4ネットワーク構成。 これは必須です。 オプションは次のとおりです。

      • subnet: IPv4サブネット。

      • ipAddresses: 使用できるIPv4アドレス。 これは、CIDR、IP範囲(包含)およびIPの任意の組合せを含むカンマ区切りリストです。 カンマの後のスペースはオプションです。 たとえば: 

        192.0.2.0/24, 192.0.2.10-192.0.2.20, 192.0.2.21

    • ipv6: VMのIPv6ネットワーク構成。 これはオプションです。 オプションは次のとおりです。

      • ipAddresses: 使用できるIPv6アドレス。 これはカンマ区切りリストです。 カンマの後のスペースはオプションです。 IPv6を使用する場合は、このオプションが必要です。 たとえば: 

        2001:db8:0f01::1-2001:db8:0f01::9/64

vmTemplateName: Oracle Linux Virtualization Manager VMテンプレートの名前。 これは、Oracle Linux Virtualization Managerインスタンスに存在する必要があります。

たとえば:

providers:
  olvm:
    controlPlaneMachine:
      olvmOvirtClusterName: Default
      vmTemplateName: ock-1.32
      olvmNetwork:
        networkName: kvm-vlan
        vnicName: nic-1
        vnicProfileName: kvm-vlan
      virtualMachine:
        memory: "8GB"
        cpu:
          topology:
            cores: 8
            sockets: 10
            threads: 2
        network:
          gateway: 1.2.3.1
          interface: enp1s0
          interfaceType: virtio
          ipv4:
            subnet: 192.0.0.0/24
            ipAddresses: 192.0.2.0/24, 192.0.2.10-192.0.2.20, 192.0.2.21
          ipv6:
            ipAddresses: 2001:db8:0f01::1-2001:db8:0f01::9/64
namespace

KubernetesクラスタAPIリソースが管理クラスタにデプロイされるKubernetesネームスペース。 デフォルトはolvmです。 たとえば: 

providers:
  olvm:
    namespace: mynamespace
olvmDatacenterName

Oracle Linux Virtualization Managerデータ・センター・インスタンスの名前。 このオプションは必須です。 たとえば: 

providers:
  olvm:
    olvmDatacenterName: myolvm
olvmOCK

ocne image uploadコマンドを使用してOracle Linux Virtualization Manager OCKイメージをアップロードするために必要な情報を設定します。次の情報が含まれます:

  • diskName: イメージのアップロード時にストレージ・ドメインに作成されるディスクの名前。 これは、VMテンプレートの作成時に指定するディスク名です。

  • diskSize: ストレージ・ドメイン内に作成されたディスクに使用される、プロビジョニングされた仮想ディスク・サイズ名。 これは、ディスク上のイメージのサイズに関係なく、VMに割り当てられるディスク領域です。 たとえば、イメージは2.5GBですが、プロビジョニングされたサイズは16GBです。

  • storageDomainName: イメージがアップロードされる既存のOracle Linux Virtualization Managerストレージ・ドメインの名前。

たとえば:

providers:
  olvm:
    ovirtOCK:
      storageDomainName: olvm-data
      diskName: ock-1.32
      diskSize: 16GB
olvmOvirtAPIServer

データ・センター内のOracle Linux Virtualization Managerクラスタのオプションを設定します。 この情報は、Oracle Linux Virtualization Manager oVirt REST APIサーバーへの接続に使用されます。 オプションは次のとおりです。

caConfigMap: CA証明書を含むConfigMapの名前およびネームスペースを構成します。 これはオプションであり、次のものが含まれます:

  • name: ConfigMapの名前。 デフォルトはolvm-caです。

  • namespace: ConfigMapのネームスペース。 デフォルトはolvmです。

credentialsSecret: Oracle Linux Virtualization Managerサーバーとの通信に必要な資格証明を含むシークレットの名前およびネームスペースを設定します。これには次が含まれます:

  • name: 秘密の名前。 デフォルトはolvm-credsです。

  • namespace: シークレットの名前空間。 デフォルトはolvmです。

insecureSkipTLSVerify: Oracle Linux Virtualization Managerサーバーへの接続時にサーバーの証明書の有効性チェックをスキップするかどうかを設定するブール。CAが必要または使用されていない場合は、これをtrueに設定します。 これはオプションです。 デフォルトはfalseです。

serverCA: Oracle Linux Virtualization Managerルート認証局(CA)がインラインです。 これは、serverCAPathオプションと相互に排他的です。 CA証明書を取得する方法については、「oVirtアップストリームのドキュメント」を参照してください。

serverCAPath: Oracle Linux Virtualization Managerルート認証局(CA)証明書へのパス。 これは、serverCAオプションと相互に排他的です。

serverURL: Oracle Linux Virtualization Managerデータ・センターに接続するためのURL。 このオプションは必須です。

たとえば:

providers:
  olvm:
    olvmOvirtAPIServer:
      serverURL: https://my.example.com/ovirt-engine
      serverCAPath: "/home/username/olvm/ca.crt"
      credentialsSecret:
        name: olvm-creds
        namespace: olvm
      caConfigMap:
        name: olvm-ca
        namespace: olvm
      insecureSkipTLSVerify: false
ovirtCsiDriver

ovirt-csi-driverの構成を設定します。 これらの設定はオプションです。 デフォルトでは、ovirt-csi-driverドライバは、必要なネームスペース、資格証明シークレット、CA証明書、ConfigMapおよびCsiDriverリソースとともに自動的にインストールされます。 構成オプションは次のとおりです:

caConfigmapName: CA証明書を含むConfigMapの名前を構成します。

controllerPluginName: ドライバの一部であるコントローラ・プラグ・インのデプロイメントの名前を設定します。 デフォルトはovirt-csi-controllerです。

credsSecretName: Oracle Linux Virtualization Managerサーバーとの通信に必要な資格証明を含むシークレットの名前を設定します。 デフォルトはovirt-csi-credsです。

csiDriverName: CsiDriverの名前を設定します。 この名前は、StorageClass (provisionerフィールドの値)を作成するときに使用されます。 デフォルトはcsi.ovirt.orgです。

install: ドライバおよび必要なリソースをインストールするかどうかを設定するブール値。 デフォルトは、trueです。

namespace: ドライバおよびすべての関連リソースが作成されるネームスペースを設定します。 デフォルトはovirt-csiです。

nodePluginName: ドライバの一部であるノード・プラグ・インのデーモン・セットの名前を設定します。 デフォルトはovirt-csi-nodeです。

たとえば:

providers:
  olvm:
    ovirtCsiDriver:
      install: true
      caConfigmapName: ovirt-csi-ca.crt
      controllerPluginName: ovirt-csi-controller
      credsSecretName: ovirt-csi-creds 
      csiDriverName: csi.ovirt.org 
      namespace: ovirt-csi
      nodePluginName: ovirt-csi-node
workerMachine

ワーカーVMノードのオプションを設定します。 オプションは次のとおりです。

olvmNetwork: VMのネットワーク設定:

  • networkName: Oracle Linux Virtualization Managerネットワーク名。 これは、Oracle Linux Virtualization Managerインスタンスに存在する必要があります。

  • vnicName: Oracle Linux Virtualization Manager VNIC名。 これはオプションです。

  • vnicProfileName: Oracle Linux Virtualization Manager VNICプロファイル名。 これは、Oracle Linux Virtualization Managerインスタンスに存在する必要があります。

olvmOvirtClusterName: Oracle Linux Virtualization Managerクラスタの名前。 これはデータ・センターに存在する必要があります。

virtualMachine: VMsのオプションを設定します。 オプションは次のとおりです。

  • cpu: CPUに関する情報。 オプションは次のとおりです。

    • topology:

      • architecture: CPUのアーキテクチャ。 デフォルトはx86_64です。

      • cores: コアの数。 デフォルトは2です。

      • sockets: ソケットの数。 デフォルトは2です。

      • threads: スレッドの数。 デフォルトは1です。

  • memory: VMsのメモリーのサイズ。 デフォルトは16GBです。

  • network: VMのネットワーク・オプションを設定します。 オプションは次のとおりです。

    • gateway: VMのネットワーク・ゲートウェイのIPアドレス。

    • interface: VMsのネットワーク・インタフェース名。 これはオプションです。 デフォルトはenp1s0です。

    • interfaceType: VMsのネットワーク・インタフェース・タイプ。 これはオプションです。 デフォルトはvirtioです。

    • ipv4: VMsのIPv4ネットワーク構成。 これは必須です。 オプションは次のとおりです。

      • subnet: IPv4サブネット。

      • ipAddresses: 使用できるIPv4アドレス。 これは、CIDR、IP範囲(包含)およびIPの任意の組合せを含むカンマ区切りリストです。 カンマの後のスペースはオプションです。 たとえば: 

        192.0.2.0/24, 192.0.2.10-192.0.2.20, 192.0.2.21

    • ipv6: VMのIPv6ネットワーク構成。 これはオプションです。 オプションは次のとおりです。

      • ipAddresses: 使用できるIPv6アドレス。 これはカンマ区切りリストです。 カンマの後のスペースはオプションです。 IPv6を使用する場合は、このオプションが必要です。 たとえば: 

        2001:db8:0f01::1-2001:db8:0f01::9/64

vmTemplateName: Oracle Linux Virtualization Manager VMテンプレートの名前。 これは、Oracle Linux Virtualization Managerインスタンスに存在する必要があります。

たとえば:

providers:
  olvm:
    workerMachine:
      olvmOvirtClusterName: Default
      vmTemplateName: ock-1.32
      olvmNetwork:
        networkName: kvm-vlan
        vnicName: nic-1
        vnicProfileName: kvm-vlan
      virtualMachine:
        memory: "16GB"
        cpu:
          topology:
            cores: 6
            sockets: 6
            threads: 3
        network:
          gateway: 1.2.3.1
          interface: enp1s0
          interfaceType: virtio
          ipv4:
            subnet: 192.0.0.0/24
            ipAddresses: 192.0.2.0/24, 192.0.2.21-192.0.2.30, 192.0.2.32
          ipv6:
            ipAddresses: 2001:db8:0f01::1-2001:db8:0f01::9/64