19.9. Subscription [operators.coreos.com/v1alpha1]


Description
サブスクリプションは、カタログへの変更を追跡することにより、Operator を最新の状態に保ちます。
タイプ
object
必須
  • metadata
  • spec

19.9.1. 仕様

Expand
プロパティータイプ説明

apiVersion

string

APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

metadata

ObjectMeta_v2

標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

spec

object

SubscriptionSpec は、インストール可能なアプリケーションを定義します

status

object

 

19.9.1.1. .spec

Description
SubscriptionSpec は、インストール可能なアプリケーションを定義します
タイプ
object
必須
  • name
  • source
  • sourceNamespace
Expand
プロパティータイプDescription

channel

string

 

config

object

SubscriptionConfig には、サブスクリプションに指定された設定が含まれています。

installPlanApproval

string

承認は、InstallPlan のユーザー承認ポリシーです。自動または手動のいずれかである必要があります。

name

string

 

source

string

 

sourceNamespace

string

 

startingCSV

string

 

19.9.1.2. .spec.config

Description
SubscriptionConfig には、サブスクリプションに指定された設定が含まれています。
タイプ
object
Expand
プロパティータイプDescription

env

array

Env は、コンテナーに設定する環境変数のリストです。更新はできません。

env[]

object

EnvVar は、コンテナーに存在する環境変数を表します。

envFrom

array

EnvFrom は、コンテナー内の環境変数に入力するソースのリストです。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。Immutable.

envFrom[]

object

EnvFromSource は、一連の ConfigMap のソースを表します

nodeSelector

object (string)

NodeSelector は、Pod がノードに収まるようにするために true である必要があるセレクターです。そのノードでスケジュールされる Pod のノードのラベルと一致する必要があるセレクター。詳細: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/

resources

object

リソースは、このコンテナーに必要なコンピューティングリソースを表します。Immutable.詳細: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/

selector

object

セレクターは、設定する Pod のラベルセレクターです。これによって Pod が選択される既存の ReplicaSet は、このデプロイメントの影響を受けるものになります。Pod テンプレートのラベルと一致する必要があります。

tolerations

array

許容値は Pod の許容値です。

tolerations[]

object

この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致するテイントを許容します。

volumeMounts

array

コンテナーに設定する VolumeMounts のリスト。

volumeMounts[]

object

VolumeMount は、コンテナー内でのボリュームのマウントについて説明します。

volumes

array

podSpec で設定するボリュームのリスト。

volumes[]

object

ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。

19.9.1.3. .spec.config.env

Description
Env は、コンテナーに設定する環境変数のリストです。更新はできません。
タイプ
array

19.9.1.4. .spec.config.env[]

Description
EnvVar は、コンテナーに存在する環境変数を表します。
タイプ
object
必須
  • name
Expand
プロパティータイプ説明

name

string

環境変数の名前。C_IDENTIFIER でなければなりません。

value

string

変数参照 $(VAR_NAME) は、コンテナー内で以前に定義された環境変数と任意のサービス環境変数を使用して展開されます。変数を解決できない場合、入力文字列の参照は変更されません。Double は単一の $ に削減されます。これにより、$(VAR_NAME) 構文をエスケープできます。つまり、(VAR_NAME) は文字列リテラル $(VAR_NAME) を生成します。変数が存在するかどうかにかかわらず、エスケープされた参照は拡張されません。デフォルトは "" です。

valueFrom

object

環境変数の値のソースです。値が空でない場合は使用できません。

19.9.1.5. .spec.config.env[].valueFrom

Description
環境変数の値のソースです。値が空でない場合は使用できません。
タイプ
object
Expand
プロパティータイプDescription

configMapKeyRef

object

ConfigMap のキーを選択します。

fieldRef

object

Pod のフィールドを選択します:metadata.name、metadata.namespace、metadata.labels '<KEY>'metadata.annotations '<KEY>'、spec.nodeName、spec.serviceAccountName、status.hostIP、status.podIP、status.podIPs。

resourceFieldRef

object

コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、limits.ephemeral-storage、requests.cpu、requests.memory、requests.ephemeral-storage) のみがサポートされています。

secretKeyRef

object

Pod の名前空間でシークレットのキーを選択します

19.9.1.6. .spec.config.env[].valueFrom.configMapKeyRef

Description
ConfigMap のキーを選択します。
タイプ
object
必須
  • key
Expand
プロパティータイプDescription

key

string

選択するキー。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

19.9.1.7. .spec.config.env[].valueFrom.fieldRef

Description
Pod のフィールドを選択します:metadata.name、metadata.namespace、metadata.labels '<KEY>'metadata.annotations '<KEY>'、spec.nodeName、spec.serviceAccountName、status.hostIP、status.podIP、status.podIPs。
タイプ
object
必須
  • fieldPath
Expand
プロパティータイプ説明

apiVersion

string

FieldPath が記述されているスキーマのバージョン。デフォルトは v1 です。

fieldPath

string

指定された API バージョンで選択するフィールドのパス。

19.9.1.8. .spec.config.env[].valueFrom.resourceFieldRef

Description
コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、limits.ephemeral-storage、requests.cpu、requests.memory、requests.ephemeral-storage) のみがサポートされています。
タイプ
object
必須
  • resource
Expand
プロパティータイプDescription

containerName

string

コンテナー名: ボリュームには必須、env 変数にはオプション

divisor

integer-or-string

公開されたリソースの出力形式を指定します。デフォルトは 1 です。

resource

string

必須: 選択するリソース

19.9.1.9. .spec.config.env[].valueFrom.secretKeyRef

Description
Pod の名前空間でシークレットのキーを選択します
タイプ
object
必須
  • key
Expand
プロパティータイプDescription

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

19.9.1.10. .spec.config.envFrom

Description
EnvFrom は、コンテナー内の環境変数に入力するソースのリストです。ソース内で定義されたキーは C_IDENTIFIER である必要があります。無効なキーはすべて、コンテナーの起動時にイベントとして報告されます。キーが複数のソースに存在する場合、最後のソースに関連付けられた値が優先されます。重複キーを持つ環境によって定義された値が優先されます。Immutable.
タイプ
array

19.9.1.11. .spec.config.envFrom[]

Description
EnvFromSource は、一連の ConfigMap のソースを表します
タイプ
object
Expand
プロパティータイプDescription

configMapRef

object

選択する ConfigMap

prefix

string

ConfigMap の各キーの前に追加するオプションの識別子。C_IDENTIFIER でなければなりません。

secretRef

object

から選択する秘密

19.9.1.12. .spec.config.envFrom[].configMapRef

Description
選択する ConfigMap
タイプ
object
Expand
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

ConfigMap を定義する必要があるかどうかを指定します

19.9.1.13. .spec.config.envFrom[].secretRef

Description
から選択する秘密
タイプ
object
Expand
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットを定義する必要があるかどうかを指定します

19.9.1.14. .spec.config.resources

Description
リソースは、このコンテナーに必要なコンピューティングリソースを表します。Immutable.詳細: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/
タイプ
object
Expand
プロパティータイプDescription

limits

integer-or-string

制限は、許容されるコンピュートリソースの最大量を記述します。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

requests

integer-or-string

要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

19.9.1.15. .spec.config.selector

Description
セレクターは、設定する Pod のラベルセレクターです。これによって Pod が選択される既存の ReplicaSet は、このデプロイメントの影響を受けるものになります。Pod テンプレートのラベルと一致する必要があります。
タイプ
object
Expand
プロパティータイプDescription

matchExpressions

array

matchExpressions はラベルセレクターの要件の一覧です。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。MatchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには key、演算子には In、値配列には value のみが含まれます。要件は AND で結合されます。

19.9.1.16. .spec.config.selector.matchExpressions

Description
matchExpressions はラベルセレクターの要件の一覧です。要件は AND で結合されます。
タイプ
array

19.9.1.17. .spec.config.selector.matchExpressions[]

Description
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
Expand
プロパティータイプDescription

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

19.9.1.18. .spec.config.tolerations

Description
許容値は Pod の許容値です。
タイプ
array

19.9.1.19. .spec.config.tolerations[]

Description
この toleration が割り当てられる Pod は、マッチング Operator <operator> を使用してトリプル <key,value,effect> と一致するテイントを許容します。
タイプ
object
Expand
プロパティータイプDescription

effect

string

effect は、照合するテイントの効果を示します。空の場合は、すべてのテイント効果に一致します。指定されている場合、許可される値は NoSchedule、PreferNoSchedule、および NoExecute です。

key

string

key は toleration が適用されるテイントキーです。空の場合は、すべてのテイントキーに一致します。キーが空の場合、Operator は Exists である必要があります。この組み合わせは、すべての値とすべてのキーに一致することを意味します。

operator

string

Operator はキーと値の関係を表します。有効な Operator は Exists および Equal です。デフォルトは Equal です。Exists は、値のワイルドカードと同等であるため、Pod は特定のカテゴリーのすべてのテイントに耐えることができます。

tolerationSeconds

integer

tolerationSeconds は、toleration (effect は NoExecute でなければならず、NoExecute 以外の場合このフィールドは無視されます) がテイントを許容する期間を表します。デフォルトでは設定されていません。つまり、テイントを永久に許容します (エビクトしないでください)。ゼロ値と負の値は、システムによって 0 (すぐにエビクト) として扱われます。

value

string

value は、toleration が一致するテイントの値です。Operator が Exists の場合、値は空である必要があります。それ以外の場合は、通常の文字列のみになります。

19.9.1.20. .spec.config.volumeMounts

Description
コンテナーに設定する VolumeMounts のリスト。
タイプ
array

19.9.1.21. .spec.config.volumeMounts[]

Description
VolumeMount は、コンテナー内でのボリュームのマウントについて説明します。
タイプ
object
必須
  • mountPath
  • name
Expand
プロパティータイプDescription

mountPath

string

ボリュームをマウントする必要があるコンテナー内のパス。':' を含めることはできません。

mountPropagation

string

mountPropagation は、マウントがホストからコンテナーに、またはその逆にどのように伝播されるかを決定します。設定されていない場合、MountPropagationNone が使用されます。このフィールドは 1.10 のベータ版です。

name

string

ボリュームの名前に一致する必要があります。

readOnly

boolean

true の場合は読み取り専用、それ以外の場合は読み取り/書き込み (false または指定なし) でマウントされます。デフォルトは false です。

subPath

string

コンテナーのボリュームをマウントする必要があるボリューム内のパス。デフォルトは (ボリュームのルート) です。

subPathExpr

string

コンテナーのボリュームをマウントする必要があるボリューム内の拡張パス。SubPath と同様に動作しますが、環境変数参照 $(VAR_NAME) は、コンテナーの環境を使用して展開されます。デフォルトは (ボリュームのルート) です。SubPathExpr と SubPath は相互に排他的です。

19.9.1.22. .spec.config.volumes

Description
podSpec で設定するボリュームのリスト。
タイプ
array

19.9.1.23. .spec.config.volumes[]

Description
ボリュームは、Pod 内の任意のコンテナーからアクセスできる Pod 内の名前付きボリュームを表します。
タイプ
object
必須
  • name
Expand
プロパティータイプDescription

awsElasticBlockStore

object

awsElasticBlockStore は、kubelet のホストマシンに割り当てられ、Pod に公開される AWS Disk リソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

azureDisk

object

azureDisk は、ホスト上の Azure Data Disk マウントを表し、Pod へのバインドマウントを表します。

azureFile

object

AzureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。

cephfs

object

CephFS は、Pod の有効期間を共有するホストでの Ceph FS マウントを表します。

cinder

object

Cinder は、kubelets ホストマシンに接続およびマウントされた Cinder ボリュームを表します。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md

configMap

object

ConfigMap は、このボリュームに入力する必要がある configMap を表します

csi

object

CSI(Container Storage Interface) は、特定の外部 CSI ドライバー (ベータ機能) によって処理される一時的なストレージを表します。

downwardAPI

object

DownwardAPI は、このボリュームに入力する必要がある Pod に関する下向き API を表します

emptyDir

object

EmptyDir は、Pod の存続期間を共有する一時ディレクトリーを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir

ephemeral

object

エフェメラルは、クラスターストレージドライバーによって処理されるボリュームを表します。ボリュームのライフサイクルは、ボリュームを定義する Pod に関連付けられています。ボリュームは、Pod が起動する前に作成され、Pod が削除されると削除されます。これは、次の場合に使用します。a)Pod の実行中にのみボリュームが必要、b) スナップショットからの復元や容量追跡などの通常のボリュームの機能が必要、c) ストレージドライバーがストレージクラスを通じて指定される、d) ストレージドライバー PersistentVolumeClaim を介した動的ボリュームプロビジョニングをサポートします (このボリュームタイプと PersistentVolumeClaim の間の接続の詳細については、EphemeralVolumeSource を参照してください)。個々の Pod のライフサイクルより長く持続するボリュームには、PersistentVolumeClaim またはベンダー固有の API の 1 つを使用します。CSI ドライバーをそのように使用する場合は、軽量のローカルエフェメラルボリュームに CSI を使用します。詳細については、ドライバーのドキュメントを参照してください。Pod は、両方のタイプのエフェメラルボリュームとパーシステントボリュームを同時に使用できます。これはベータ機能であり、GenericEphemeralVolume 機能ゲートが有効になっている場合にのみ使用できます。

fc

object

FC は、kubelet のホストマシンに接続されてから Pod に公開されるファイバーチャネルリソースを表します。

flexVolume

object

FlexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。

flocker

object

Flocker は、kubelet のホストマシンに接続されている Flocker ボリュームを表します。これは、実行中の Flocker 制御サービスによって異なります

gcePersistentDisk

object

GCEPersistentDisk は、kubelet のホストマシンに接続されてから Pod に公開される GCE ディスクリソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

gitRepo

object

GitRepo は、特定のリビジョンの git リポジトリーを表します。非推奨:GitRepo は非推奨です。git レポジトリを使用してコンテナーをプロビジョニングするには、Git を使用してレポジトリのクローンを作成する InitContainer に EmptyDir をマウントしてから、Pod のコンテナーに EmptyDir をマウントします。

glusterfs

object

Glusterfs は、Pod の存続期間を共有するホスト上の Glusterfs マウントを表します。詳細: https://examples.k8s.io/volumes/glusterfs/README.md

hostPath

object

HostPath は、コンテナーに直接公開されているホストマシン上の既存のファイルまたはディレクトリーを表します。これは通常、ホストマシンの表示を許可されているシステムエージェントまたはその他の特権的なものに使用されます。ほとんどのコンテナーはこれを必要としません。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath --- TODO(jonesdl) ホストディレクトリーのマウントを使用できる人、およびホストディレクトリーを読み取り/書き込みでマウントできる人/できない人を制限する必要があります。

iscsi

object

ISCSI は、kubelet のホストマシンに接続されてから Pod に公開される ISCSI ディスクリソースを表します。詳細: https://examples.k8s.io/volumes/iscsi/README.md

name

string

ボリュームの名前。DNS_LABEL であり、Pod 内で一意である必要があります。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

nfs

object

NFS は、Pod の有効期間を共有するホスト上の NFS マウントを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs

persistentVolumeClaim

object

PersistentVolumeClaimVolumeSource は、同じ名前空間内の PersistentVolumeClaim への参照を表します。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

photonPersistentDisk

object

photonPersistentDisk は、kubelet ホストマシンに接続およびマウントされた PhotonController の PhotonPersistentDisk を表します。

portworxVolume

object

PortworxVolume は、kubelet ホストマシンに接続およびマウントされた portworx ボリュームを表します。

projected

object

オールインワンリソースシークレット、configmaps、および下位 API のアイテム

quobyte

object

Quobyte は、Pod の有効期限を共有するホストでの Quobyte マウントを表します

rbd

object

RBD は、Pod の有効期間を共有するホストの Rados ブロックデバイスマウントを表します。詳細: https://examples.k8s.io/volumes/rbd/README.md

scaleIO

object

ScaleIO は、Kubernetes ノードに接続およびマウントされた ScaleIO 永続ボリュームを表します。

secret

object

シークレットは、このボリュームに入力する必要があるシークレットを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret

storageos

object

StorageOS は、Kubernetes ノードに接続およびマウントされた StorageOS ボリュームを表します。

vsphereVolume

object

VsphereVolume は、kubelet ホストマシンに接続およびマウントされた vSphere ボリュームを表します。

19.9.1.24. .spec.config.volumes[].awsElasticBlockStore

Description
awsElasticBlockStore は、kubelet のホストマシンに割り当てられ、Pod に公開される AWS Disk リソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
タイプ
object
必須
  • volumeID
Expand
プロパティータイプDescription

fsType

string

マウントするボリュームのファイルシステムタイプ。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例:ext4、xfs、ntfs。指定されていない場合、暗黙的に ext4 であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore TODO: ファイルシステムのエラーによるマシンの侵害を防ぐにはどうすればよいですか ?

パーティション

integer

マウントするボリューム内のパーティション。省略した場合、デフォルトではボリューム名でマウントします。例: ボリューム/dev/sda1 の場合、パーティションを 1 として指定します。同様に、/dev/sda のボリュームパーティションは 0 です (または、プロパティーを空のままにしておくこともできます)。

readOnly

boolean

true を指定すると、VolumeMounts の ReadOnly プロパティーが強制的に true に設定されます。省略した場合、デフォルトは false です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

volumeID

string

AWS の永続ディスクリソースの一意の ID(Amazon EBS ボリューム)。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

19.9.1.25. .spec.config.volumes[].azureDisk

Description
azureDisk は、ホスト上の Azure Data Disk マウントを表し、Pod へのバインドマウントを表します。
タイプ
object
必須
  • diskName
  • diskURI
Expand
プロパティータイプDescription

cachingMode

string

ホストキャッシングモード: なし、読み取り専用、読み取り/書き込み。

diskName

string

Blob ストレージのデータディスクの名前。

diskURI

string

BLOB ストレージ内のデータディスクの URI

fsType

string

マウントするファイルシステムタイプ。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。元。ext4、xfs、ntfs。指定されていない場合、暗黙的に ext4 であると推測されます。

kind

string

期待値共有: ストレージアカウントごとに複数の BLOB ディスク専用: ストレージアカウントごとに単一の BLOB ディスク管理対象:Azure 管理対象データディスク (管理対象可用性セットのみ)。デフォルトは共有

readOnly

boolean

デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

19.9.1.26. .spec.config.volumes[].azureFile

Description
AzureFile は、ホスト上の Azure File Service マウントを表し、マウントを Pod にバインドします。
タイプ
object
必須
  • secretName
  • shareName
Expand
プロパティータイプDescription

readOnly

boolean

デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

secretName

string

Azure ストレージアカウントの名前とキーを含むシークレットの名前

shareName

string

共有名。

19.9.1.27. .spec.config.volumes[].cephfs

Description
CephFS は、Pod の有効期間を共有するホストでの Ceph FS マウントを表します。
タイプ
object
必須
  • monitors
Expand
プロパティータイプDescription

monitors

array (string)

必須: モニターは Ceph モニターのコレクションです。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

string

オプション: 完全な Ceph ツリーではなく、マウントされたルートとして使用されます。デフォルトは/です。

readOnly

boolean

オプション: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

string

オプション: SecretFile はユーザーのキーリングへのパスです。デフォルトは /etc/ceph/user.secret です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

object

オプション:SecretRef はユーザーの認証シークレットへの参照であり、デフォルトは空です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

user

string

オプション: ユーザーは rados ユーザー名、デフォルトは admin です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

19.9.1.28. .spec.config.volumes[].cephfs.secretRef

Description
オプション:SecretRef はユーザーの認証シークレットへの参照であり、デフォルトは空です。詳細: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
タイプ
object
Expand
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

19.9.1.29. .spec.config.volumes[].cinder

Description
Cinder は、kubelets ホストマシンに接続およびマウントされた Cinder ボリュームを表します。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md
タイプ
object
必須
  • volumeID
Expand
プロパティータイプDescription

fsType

string

マウントするファイルシステムタイプ。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。例:ext4、xfs、ntfs。指定されていない場合、暗黙的に ext4 であると推測されます。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

boolean

オプション: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

object

オプション:OpenStack への接続に使用されるパラメーターを含むシークレットオブジェクトを指します。

volumeID

string

燃えがらのボリュームを識別するために使用されるボリューム ID。詳細: https://examples.k8s.io/mysql-cinder-pd/README.md

19.9.1.30. .spec.config.volumes[].cinder.secretRef

Description
オプション:OpenStack への接続に使用されるパラメーターを含むシークレットオブジェクトを指します。
タイプ
object
Expand
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

19.9.1.31. .spec.config.volumes[].configMap

Description
ConfigMap は、このボリュームに入力する必要がある configMap を表します
タイプ
object
Expand
プロパティータイプDescription

defaultMode

integer

必要に応じて、デフォルトで作成されたファイルでパーミッションを設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

items

array

指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームに展開され、名前がキーであり、内容が値になります。指定されている場合、一覧表示されるキーは指定されたパスに展開され、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。

items[]

object

文字列キーをボリューム内のパスにマップします。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

19.9.1.32. .spec.config.volumes[].configMap.items

Description
指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームに展開され、名前がキーであり、内容が値になります。指定されている場合、一覧表示されるキーは指定されたパスに展開され、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
タイプ
array

19.9.1.33. .spec.config.volumes[].configMap.items[]

Description
文字列キーをボリューム内のパスにマップします。
タイプ
object
必須
  • key
  • path
Expand
プロパティータイプDescription

key

string

プロジェクトの鍵。

mode

integer

オプション: このファイルにアクセス許可を設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

キーをマップするファイルの相対パス。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。

19.9.1.34. .spec.config.volumes[].csi

Description
CSI(Container Storage Interface) は、特定の外部 CSI ドライバー (ベータ機能) によって処理される一時的なストレージを表します。
タイプ
object
必須
  • driver
Expand
プロパティータイプDescription

driver

string

Driver は、このボリュームを処理する CSI ドライバーの名前です。クラスターに登録されている正しい名前については、管理者に相談してください。

fsType

string

マウントするファイルシステムタイプ。元。ext4、xfs、ntfs。指定しない場合、空の値が関連する CSI ドライバーに渡され、適用するデフォルトのファイルシステムが決定されます。

nodePublishSecretRef

object

NodePublishSecretRef は、CSINodePublishVolume および NodeUnpublishVolume 呼び出しを完了するために CSI ドライバーに渡す機密情報を含むシークレットオブジェクトへの参照です。このフィールドはオプションであり、シークレットが不要な場合は空の場合があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレット参照が渡されます。

readOnly

boolean

ボリュームの読み取り専用設定を指定します。デフォルトは false (読み取り/書き込み) です。

volumeAttributes

object (string)

VolumeAttributes は、CSI ドライバーに渡されるドライバー固有のプロパティーを格納します。サポートされている値については、ドライバーのドキュメントを参照してください。

19.9.1.35. .spec.config.volumes[].csi.nodePublishSecretRef

Description
NodePublishSecretRef は、CSINodePublishVolume および NodeUnpublishVolume 呼び出しを完了するために CSI ドライバーに渡す機密情報を含むシークレットオブジェクトへの参照です。このフィールドはオプションであり、シークレットが不要な場合は空の場合があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレット参照が渡されます。
タイプ
object
Expand
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

19.9.1.36. .spec.config.volumes[].downwardAPI

Description
DownwardAPI は、このボリュームに入力する必要がある Pod に関する下向き API を表します
タイプ
object
Expand
プロパティータイプDescription

defaultMode

integer

オプション: デフォルトで作成されたファイルで使用するモードビット。オプション: デフォルトで作成されたファイルのパーミッションを設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

items

array

アイテムは、下位 API ボリュームファイルのリストです

items[]

object

DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します

19.9.1.37. .spec.config.volumes[].downwardAPI.items

Description
アイテムは、下位 API ボリュームファイルのリストです
タイプ
array

19.9.1.38. .spec.config.volumes[].downwardAPI.items[]

Description
DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します
タイプ
object
必須
  • path
Expand
プロパティータイプDescription

fieldRef

object

必須:Pod のフィールドを選択します。注釈、ラベル、名前、名前空間のみがサポートされます。

mode

integer

オプション: このファイルの権限を設定するために使用されるモードビットは、0000 から 0777 までの 8 進数値、または 0 から 511 までの 10 進数値でなければなりません。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

必須: パスは、作成するファイルの相対パス名です。絶対パスまたは..パスを含めることはできません。utf-8 でエンコードする必要があります。相対パスの最初の項目は..で始まってはなりません。

resourceFieldRef

object

コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。

19.9.1.39. .spec.config.volumes[].downwardAPI.items[].fieldRef

Description
必須:Pod のフィールドを選択します。注釈、ラベル、名前、名前空間のみがサポートされます。
タイプ
object
必須
  • fieldPath
Expand
プロパティータイプ説明

apiVersion

string

FieldPath が記述されているスキーマのバージョン。デフォルトは v1 です。

fieldPath

string

指定された API バージョンで選択するフィールドのパス。

19.9.1.40. .spec.config.volumes[].downwardAPI.items[].resourceFieldRef

Description
コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。
タイプ
object
必須
  • resource
Expand
プロパティータイプDescription

containerName

string

コンテナー名: ボリュームには必須、env 変数にはオプション

divisor

integer-or-string

公開されたリソースの出力形式を指定します。デフォルトは 1 です。

resource

string

必須: 選択するリソース

19.9.1.41. .spec.config.volumes[].emptyDir

Description
EmptyDir は、Pod の存続期間を共有する一時ディレクトリーを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir
タイプ
object
Expand
プロパティータイプDescription

medium

string

このディレクトリーをバックアップする必要がある記憶媒体のタイプ。デフォルトはです。これは、ノードのデフォルトのメディアを使用することを意味します。空の文字列 (デフォルト) またはメモリーである必要があります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#emptydir

sizeLimit

integer-or-string

この EmptyDir ボリュームに必要なローカルストレージの合計量。サイズ制限はメモリーメディアにも適用されます。メモリーメディア EmptyDir での最大使用量は、ここで指定された SizeLimit と Pod 内のすべてのコンテナーのメモリー制限の合計との間の最小値になります。デフォルトは nil です。これは、制限が未定義であることを意味します。詳細: http://kubernetes.io/docs/user-guide/volumes#emptydir

19.9.1.42. .spec.config.volumes[].ephemeral

Description
エフェメラルは、クラスターストレージドライバーによって処理されるボリュームを表します。ボリュームのライフサイクルは、ボリュームを定義する Pod に関連付けられています。ボリュームは、Pod が起動する前に作成され、Pod が削除されると削除されます。これは、次の場合に使用します。a)Pod の実行中にのみボリュームが必要、b) スナップショットからの復元や容量追跡などの通常のボリュームの機能が必要、c) ストレージドライバーがストレージクラスを通じて指定される、d) ストレージドライバー PersistentVolumeClaim を介した動的ボリュームプロビジョニングをサポートします (このボリュームタイプと PersistentVolumeClaim の間の接続の詳細については、EphemeralVolumeSource を参照してください)。個々の Pod のライフサイクルより長く持続するボリュームには、PersistentVolumeClaim またはベンダー固有の API の 1 つを使用します。CSI ドライバーをそのように使用する場合は、軽量のローカルエフェメラルボリュームに CSI を使用します。詳細については、ドライバーのドキュメントを参照してください。Pod は、両方のタイプのエフェメラルボリュームとパーシステントボリュームを同時に使用できます。これはベータ機能であり、GenericEphemeralVolume 機能ゲートが有効になっている場合にのみ使用できます。
タイプ
object
Expand
プロパティータイプDescription

volumeClaimTemplate

object

ボリュームをプロビジョニングするためのスタンドアロン PVC を作成するために使用されます。この EphemeralVolumeSource が埋め込まれている Pod が PVC の所有者になります。つまり、PVC は Pod と一緒に削除されます。PVC の名前は <podname >-< volumename> になります。ここで、<volumename>PodSpec.Volumes アレイエントリーからの名前です。連結された名前が PVC に対して有効でない場合 (たとえば、長すぎる場合)、Pod 検証は Pod を拒否します。Pod が所有していないその名前の既存の PVC は、無関係なボリュームを誤って使用することを避けるために、Pod に使用され ません。Pod の起動は、無関係の PVC が削除されるまでブロックされます。そのような事前に作成された PVC が Pod で使用されることを意図している場合、Pod が存在すると、PVC は Pod への所有者参照で更新する必要があります。通常、これは必要ありませんが、壊れたクラスターを手動で再構築する場合に役立つことがあります。このフィールドは読み取り専用であり、作成後に Kubernetes が PVC に変更を加えることはありません。必須です。nil であってはなりません。

19.9.1.43. .spec.config.volumes[].ephemeral.volumeClaimTemplate

Description
ボリュームをプロビジョニングするためのスタンドアロン PVC を作成するために使用されます。この EphemeralVolumeSource が埋め込まれている Pod が PVC の所有者になります。つまり、PVC は Pod と一緒に削除されます。PVC の名前は <podname >-< volumename> になります。ここで、<volumename>PodSpec.Volumes アレイエントリーからの名前です。連結された名前が PVC に対して有効でない場合 (たとえば、長すぎる場合)、Pod 検証は Pod を拒否します。Pod が所有していないその名前の既存の PVC は、無関係なボリュームを誤って使用することを避けるために、Pod に使用され ません。Pod の起動は、無関係の PVC が削除されるまでブロックされます。そのような事前に作成された PVC が Pod で使用されることを意図している場合、Pod が存在すると、PVC は Pod への所有者参照で更新する必要があります。通常、これは必要ありませんが、壊れたクラスターを手動で再構築する場合に役立つことがあります。このフィールドは読み取り専用であり、作成後に Kubernetes が PVC に変更を加えることはありません。必須です。nil であってはなりません。
タイプ
object
必須
  • spec
Expand
プロパティータイプDescription

metadata

object

PVC の作成時に PVC にコピーされるラベルと注釈が含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。

spec

object

PersistentVolumeClaim の仕様。コンテンツ全体が、このテンプレートから作成された PVC に変更されずにコピーされます。PersistentVolumeClaim と同じフィールドがここでも有効です。

19.9.1.44. .spec.config.volumes[].ephemeral.volumeClaimTemplate.metadata

Description
PVC の作成時に PVC にコピーされるラベルと注釈が含まれる場合があります。他のフィールドは許可されておらず、検証中に拒否されます。
タイプ
object

19.9.1.45. .spec.config.volumes[].ephemeral.volumeClaimTemplate.spec

Description
PersistentVolumeClaim の仕様。コンテンツ全体が、このテンプレートから作成された PVC に変更されずにコピーされます。PersistentVolumeClaim と同じフィールドがここでも有効です。
タイプ
object
Expand
プロパティータイプDescription

accessModes

array (string)

AccessModes には、ボリュームに割り当てる必要のあるアクセスモードが含まれます。詳細については、https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 を参照してください。

dataSource

object

このフィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource 機能ゲートが有効になっている場合、このフィールドは常に DataSourceRef フィールドと同じ内容になります。

dataSourceRef

object

空でないボリュームが必要な場合は、ボリュームにデータを取り込むオブジェクトを指定します。これは、空でない API グループ (コアオブジェクトではない) または PersistentVolumeClaim オブジェクトの任意のローカルオブジェクトである可能性があります。このフィールドが指定されている場合、ボリュームバインディングは、指定されたオブジェクトのタイプが、インストールされているボリュームポピュレーターまたはダイナミックプロビジョナーと一致する場合にのみ成功します。このフィールドは、DataSource フィールドの機能を置き換えるため、両方のフィールドが空でない場合は、同じ値である必要があります。下位互換性のために、両方のフィールド (DataSource と DataSourceRef) は、一方が空でもう一方が空でない場合、自動的に同じ値に設定されます。DataSource と DataSourceRef には 2 つの重要な違いがあります。*DataSource は 2 つの特定のタイプのオブジェクトのみを許可しますが、DataSourceRef は非コアオブジェクトと PersistentVolumeClaim オブジェクトを許可します。* DataSource は許可されていない値を無視 (ドロップ) しますが、DataSourceRef はすべての値を保持し、許可されていない値が指定されている場合はエラーを生成します。(アルファ) このフィールドを使用するには、AnyVolumeDataSource 機能ゲートを有効にする必要があります。

resources

object

リソースは、ボリュームに必要な最小リソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources

selector

object

バインディングを考慮するためのボリュームに対するラベルのクエリー。

storageClassName

string

要求で必要になる StorageClass の名前。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeMode

string

volumeMode は、要求に必要なボリュームのタイプを定義します。Filesystem の値は、要求仕様に含まれていない場合に暗示されます。

volumeName

string

volumeName は、この要求をサポートする PersistentVolume へのバインディング参照です。

19.9.1.46. .spec.config.volumes[].ephemeral.volumeClaimTemplate.spec.dataSource

Description
このフィールドは、次のいずれかを指定するために使用できます。*既存の VolumeSnapshot オブジェクト (snapshot.storage.k8s.io/VolumeSnapshot)*既存の PVC(PersistentVolumeClaim) プロビジョナーまたは外部コントローラーが指定されたデータソースをサポートできる場合、指定されたデータソースのコンテンツに基づく新しいボリューム。AnyVolumeDataSource 機能ゲートが有効になっている場合、このフィールドは常に DataSourceRef フィールドと同じ内容になります。
タイプ
object
必須
  • kind
  • name
Expand
プロパティータイプDescription

apiGroup

string

APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合には、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプについては、APIGroup が必要です。

kind

string

kind は参照されているリソースのタイプです。

name

string

name は、参照されているリソースの名前です。

19.9.1.47. .spec.config.volumes[].ephemeral.volumeClaimTemplate.spec.dataSourceRef

Description
空でないボリュームが必要な場合は、ボリュームにデータを取り込むオブジェクトを指定します。これは、空でない API グループ (コアオブジェクトではない) または PersistentVolumeClaim オブジェクトの任意のローカルオブジェクトである可能性があります。このフィールドが指定されている場合、ボリュームバインディングは、指定されたオブジェクトのタイプが、インストールされているボリュームポピュレーターまたはダイナミックプロビジョナーと一致する場合にのみ成功します。このフィールドは、DataSource フィールドの機能を置き換えるため、両方のフィールドが空でない場合は、同じ値である必要があります。下位互換性のために、両方のフィールド (DataSource と DataSourceRef) は、一方が空でもう一方が空でない場合、自動的に同じ値に設定されます。DataSource と DataSourceRef には 2 つの重要な違いがあります。*DataSource は 2 つの特定のタイプのオブジェクトのみを許可しますが、DataSourceRef は非コアオブジェクトと PersistentVolumeClaim オブジェクトを許可します。* DataSource は許可されていない値を無視 (ドロップ) しますが、DataSourceRef はすべての値を保持し、許可されていない値が指定されている場合はエラーを生成します。(アルファ) このフィールドを使用するには、AnyVolumeDataSource 機能ゲートを有効にする必要があります。
タイプ
object
必須
  • kind
  • name
Expand
プロパティータイプDescription

apiGroup

string

APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合には、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプについては、APIGroup が必要です。

kind

string

kind は参照されているリソースのタイプです。

name

string

name は、参照されているリソースの名前です。

19.9.1.48. .spec.config.volumes[].ephemeral.volumeClaimTemplate.spec.resources

Description
リソースは、ボリュームに必要な最小リソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
タイプ
object
Expand
プロパティータイプDescription

limits

integer-or-string

制限は、許容されるコンピュートリソースの最大量を記述します。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

requests

integer-or-string

要求は、必要なコンピュートリソースの最小量を記述します。コンテナーについて Requests が省略される場合、明示的に指定される場合にデフォルトで Limits に設定されます。指定しない場合は、実装定義の値に設定されます。詳細については、https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ を参照してください。

19.9.1.49. .spec.config.volumes[].ephemeral.volumeClaimTemplate.spec.selector

Description
バインディングを考慮するためのボリュームに対するラベルのクエリー。
タイプ
object
Expand
プロパティータイプDescription

matchExpressions

array

matchExpressions はラベルセレクターの要件の一覧です。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。MatchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには key、演算子には In、値配列には value のみが含まれます。要件は AND で結合されます。

19.9.1.50. .spec.config.volumes[].ephemeral.volumeClaimTemplate.spec.selector.matchExpressions

Description
matchExpressions はラベルセレクターの要件の一覧です。要件は AND で結合されます。
タイプ
array

19.9.1.51. .spec.config.volumes[].ephemeral.volumeClaimTemplate.spec.selector.matchExpressions[]

Description
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
タイプ
object
必須
  • key
  • operator
Expand
プロパティータイプDescription

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

19.9.1.52. .spec.config.volumes[].fc

Description
FC は、kubelet のホストマシンに接続されてから Pod に公開されるファイバーチャネルリソースを表します。
タイプ
object
Expand
プロパティータイプDescription

fsType

string

マウントするファイルシステムタイプ。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。元。ext4、xfs、ntfs。指定されていない場合、暗黙的に ext4 であると推測されます。TODO: ファイルシステムのエラーがマシンを危険にさらすのを防ぐにはどうすればよいですか ?

lun

integer

オプション:FC ターゲットの論理ユニット番号

readOnly

boolean

オプション: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

targetWWNs

array (string)

オプション:FC ターゲットワールドワイドネーム (WWN)

wwids

array (string)

オプション:FC ボリュームのワールドワイド ID(wwids)wwids または targetWWN と lun の組み合わせのいずれかを設定する必要がありますが、両方を同時に設定することはできません。

19.9.1.53. .spec.config.volumes[].flexVolume

Description
FlexVolume は、exec ベースのプラグインを使用してプロビジョニング/接続される汎用ボリュームリソースを表します。
タイプ
object
必須
  • driver
Expand
プロパティータイプDescription

driver

string

Driver は、このボリュームに使用するドライバーの名前です。

fsType

string

マウントするファイルシステムタイプ。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。元。ext4、xfs、ntfs。デフォルトのファイルシステムは FlexVolume スクリプトに依存します。

options

object (string)

オプション: 追加のコマンドオプション (ある場合)。

readOnly

boolean

オプション: デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

secretRef

object

オプション:SecretRef は、プラグインスクリプトに渡す機密情報を含むシークレットオブジェクトへの参照です。シークレットオブジェクトが指定されていない場合、これは空になる可能性があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレットがプラグインスクリプトに渡されます。

19.9.1.54. .spec.config.volumes[].flexVolume.secretRef

Description
オプション:SecretRef は、プラグインスクリプトに渡す機密情報を含むシークレットオブジェクトへの参照です。シークレットオブジェクトが指定されていない場合、これは空になる可能性があります。シークレットオブジェクトに複数のシークレットが含まれている場合、すべてのシークレットがプラグインスクリプトに渡されます。
タイプ
object
Expand
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

19.9.1.55. .spec.config.volumes[].flocker

Description
Flocker は、kubelet のホストマシンに接続されている Flocker ボリュームを表します。これは、実行中の Flocker 制御サービスによって異なります
タイプ
object
Expand
プロパティータイプDescription

datasetName

string

メタデータとして保存されているデータセットの名前→Flocker のデータセットの名前は非推奨と見なす必要があります

datasetUUID

string

データセットの UUID。これは Flocker データセットの一意の識別子です

19.9.1.56. .spec.config.volumes[].gcePersistentDisk

Description
GCEPersistentDisk は、kubelet のホストマシンに接続されてから Pod に公開される GCE ディスクリソースを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
タイプ
object
必須
  • pdName
Expand
プロパティータイプDescription

fsType

string

マウントするボリュームのファイルシステムタイプ。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例:ext4、xfs、ntfs。指定されていない場合、暗黙的に ext4 であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk TODO: ファイルシステムのエラーによるマシンの侵害を防ぐにはどうすればよいですか ?

パーティション

integer

マウントするボリューム内のパーティション。省略した場合、デフォルトではボリューム名でマウントします。例: ボリューム/dev/sda1 の場合、パーティションを 1 として指定します。同様に、/dev/sda のボリュームパーティションは 0 です (または、プロパティーを空のままにしておくこともできます)。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

pdName

string

GCE での PD リソースの一意の名前。GCE でディスクを識別するために使用されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

readOnly

boolean

ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。デフォルトは false です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

19.9.1.57. .spec.config.volumes[].gitRepo

Description
GitRepo は、特定のリビジョンの git リポジトリーを表します。非推奨:GitRepo は非推奨です。git レポジトリを使用してコンテナーをプロビジョニングするには、Git を使用してレポジトリのクローンを作成する InitContainer に EmptyDir をマウントしてから、Pod のコンテナーに EmptyDir をマウントします。
タイプ
object
必須
  • repository
Expand
プロパティータイプDescription

directory

string

ターゲットディレクトリー名。'..' を含まない、または..で始まらないようにする必要があります。もしも '。' が提供されている場合、ボリュームディレクトリーは git リポジトリーになります。それ以外の場合、指定されている場合、ボリュームには、指定された名前のサブディレクトリーに git リポジトリーが含まれます。

repository

string

リポジトリー URL

revision

string

指定されたリビジョンのハッシュをコミットします。

19.9.1.58. .spec.config.volumes[].glusterfs

Description
Glusterfs は、Pod の存続期間を共有するホスト上の Glusterfs マウントを表します。詳細: https://examples.k8s.io/volumes/glusterfs/README.md
タイプ
object
必須
  • endpoints
  • path
Expand
プロパティータイプDescription

endpoints

string

EndpointsName は、Glusterfs トポロジーの詳細を示すエンドポイント名です。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

string

パスは Glusterfs ボリュームパスです。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

readOnly

boolean

ここでの読み取り専用は、Glusterfs ボリュームを読み取り専用のアクセス許可で強制的にマウントします。デフォルトは false です。詳細: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

19.9.1.59. .spec.config.volumes[].hostPath

Description
HostPath は、コンテナーに直接公開されているホストマシン上の既存のファイルまたはディレクトリーを表します。これは通常、ホストマシンの表示を許可されているシステムエージェントまたはその他の特権的なものに使用されます。ほとんどのコンテナーはこれを必要としません。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath --- TODO(jonesdl) ホストディレクトリーのマウントを使用できる人、およびホストディレクトリーを読み取り/書き込みでマウントできる人/できない人を制限する必要があります。
タイプ
object
必須
  • path
Expand
プロパティータイプDescription

path

string

ホスト上のディレクトリーのパス。パスがシンボリックリンクの場合、実際のパスへのリンクをたどります。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

type

string

HostPath ボリュームのデフォルトのタイプは "" です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

19.9.1.60. .spec.config.volumes[].iscsi

Description
ISCSI は、kubelet のホストマシンに接続されてから Pod に公開される ISCSI ディスクリソースを表します。詳細: https://examples.k8s.io/volumes/iscsi/README.md
タイプ
object
必須
  • iqn
  • lun
  • targetPortal
Expand
プロパティータイプDescription

chapAuthDiscovery

boolean

iSCSI ディスカバリー CHAP 認証をサポートするかどうか

chapAuthSession

boolean

iSCSI セッション CHAP 認証をサポートするかどうか

fsType

string

マウントするボリュームのファイルシステムタイプ。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例:ext4、xfs、ntfs。指定されていない場合、暗黙的に ext4 であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#iscsi TODO: ファイルシステムのエラーによるマシンの侵害を防ぐにはどうすればよいですか ?

initiatorName

string

カスタム iSCSI イニシエーター名。iscsiInterface と同時に initiatorName を指定すると、接続用に新しい iSCSI インターフェイス < ターゲットポータル >:< ボリューム名 > が作成されます。

iqn

string

ターゲット iSCSI 修飾名。

iscsiInterface

string

iSCSI トランスポートを使用する iSCSI インターフェイス名。デフォルトは defaults (tcp) です。

lun

integer

iSCSI ターゲットの Lun 番号。

portals

array (string)

iSCSI ターゲットポータルリスト。ポートがデフォルト以外の場合、ポータルは IP または ip_addr:port のいずれかです (通常は TCP ポート 860 および 3260)。

readOnly

boolean

ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。デフォルトは false です。

secretRef

object

iSCSI ターゲットおよびイニシエーター認証の CHAP シークレット

targetPortal

string

iSCSI ターゲットポータル。ポートがデフォルト以外の場合、ポータルは IP または ip_addr:port のいずれかです (通常は TCP ポート 860 および 3260)。

19.9.1.61. .spec.config.volumes[].iscsi.secretRef

Description
iSCSI ターゲットおよびイニシエーター認証の CHAP シークレット
タイプ
object
Expand
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

19.9.1.62. .spec.config.volumes[].nfs

Description
NFS は、Pod の有効期間を共有するホスト上の NFS マウントを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs
タイプ
object
必須
  • path
  • server
Expand
プロパティータイプDescription

path

string

NFS サーバーがエクスポートしているパス。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs

readOnly

boolean

ここでの読み取り専用は、NFS エクスポートを読み取り専用のアクセス許可でマウントするように強制します。デフォルトは false です。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs

server

string

サーバーは、NFS サーバーのホスト名または IP アドレスです。詳細: https://kubernetes.io/docs/concepts/storage/volumes#nfs

19.9.1.63. .spec.config.volumes[].persistentVolumeClaim

Description
PersistentVolumeClaimVolumeSource は、同じ名前空間内の PersistentVolumeClaim への参照を表します。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids
タイプ
object
必須
  • claimName
Expand
プロパティータイプDescription

claimName

string

ClaimName は、このボリュームを使用する Pod と同じ名前空間にある PersistentVolumeClaim の名前です。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

readOnly

boolean

VolumeMounts で ReadOnly 設定を強制します。デフォルト: false

19.9.1.64. .spec.config.volumes[].photonPersistentDisk

Description
photonPersistentDisk は、kubelet ホストマシンに接続およびマウントされた PhotonController の PhotonPersistentDisk を表します。
タイプ
object
必須
  • pdID
Expand
プロパティータイプDescription

fsType

string

マウントするファイルシステムタイプ。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。元。ext4、xfs、ntfs。指定されていない場合、暗黙的に ext4 であると推測されます。

pdID

string

PhotonController 永続ディスクを識別する ID

19.9.1.65. .spec.config.volumes[].portworxVolume

Description
PortworxVolume は、kubelet ホストマシンに接続およびマウントされた portworx ボリュームを表します。
タイプ
object
必須
  • volumeID
Expand
プロパティータイプDescription

fsType

string

FSType は、マウントするファイルシステムタイプを表します。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。元。ext4、xfs。指定されていない場合、暗黙的に ext4 であると推測されます。

readOnly

boolean

デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

volumeID

string

VolumeID は、Portworx ボリュームを一意に識別します

19.9.1.66. .spec.config.volumes[].projected

Description
オールインワンリソースシークレット、configmaps、および下位 API のアイテム
タイプ
object
Expand
プロパティータイプDescription

defaultMode

integer

作成されたファイルのパーミッションを設定するために使用されるモードビットがデフォルトで設定されています。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

ソース

array

ボリューム予測のリスト

sources[]

object

サポートされている他のボリュームタイプと一緒に展開される可能性のあるプロジェクション

19.9.1.67. .spec.config.volumes[].projected.sources

Description
ボリューム予測のリスト
タイプ
array

19.9.1.68. .spec.config.volumes[].projected.sources[]

Description
サポートされている他のボリュームタイプと一緒に展開される可能性のあるプロジェクション
タイプ
object
Expand
プロパティータイプDescription

configMap

object

プロジェクトする configMap データに関する情報

downwardAPI

object

プロジェクトする downwardAPI データに関する情報

secret

object

プロジェクトする秘密データに関する情報

serviceAccountToken

object

プロジェクトする serviceAccountToken データに関する情報

19.9.1.69. .spec.config.volumes[].projected.sources[].configMap

Description
プロジェクトする configMap データに関する情報
タイプ
object
Expand
プロパティータイプDescription

items

array

指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームに展開され、名前がキーであり、内容が値になります。指定されている場合、一覧表示されるキーは指定されたパスに展開され、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。

items[]

object

文字列キーをボリューム内のパスにマップします。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

19.9.1.70. .spec.config.volumes[].projected.sources[].configMap.items

Description
指定されていない場合、参照される ConfigMap の Data フィールドのそれぞれのキーと値のペアはボリュームに展開され、名前がキーであり、内容が値になります。指定されている場合、一覧表示されるキーは指定されたパスに展開され、リストされていないキーはありません。ConfigMap に存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
タイプ
array

19.9.1.71. .spec.config.volumes[].projected.sources[].configMap.items[]

Description
文字列キーをボリューム内のパスにマップします。
タイプ
object
必須
  • key
  • path
Expand
プロパティータイプDescription

key

string

プロジェクトの鍵。

mode

integer

オプション: このファイルにアクセス許可を設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

キーをマップするファイルの相対パス。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。

19.9.1.72. .spec.config.volumes[].projected.sources[].downwardAPI

Description
プロジェクトする downwardAPI データに関する情報
タイプ
object
Expand
プロパティータイプDescription

items

array

アイテムは DownwardAPIVolume ファイルのリストです

items[]

object

DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します

19.9.1.73. .spec.config.volumes[].projected.sources[].downwardAPI.items

Description
アイテムは DownwardAPIVolume ファイルのリストです
タイプ
array

19.9.1.74. .spec.config.volumes[].projected.sources[].downwardAPI.items[]

Description
DownwardAPIVolumeFile は、Pod フィールドを含むファイルを作成するための情報を表します
タイプ
object
必須
  • path
Expand
プロパティータイプDescription

fieldRef

object

必須:Pod のフィールドを選択します。注釈、ラベル、名前、名前空間のみがサポートされます。

mode

integer

オプション: このファイルの権限を設定するために使用されるモードビットは、0000 から 0777 までの 8 進数値、または 0 から 511 までの 10 進数値でなければなりません。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

必須: パスは、作成するファイルの相対パス名です。絶対パスまたは..パスを含めることはできません。utf-8 でエンコードする必要があります。相対パスの最初の項目は..で始まってはなりません。

resourceFieldRef

object

コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。

19.9.1.75. .spec.config.volumes[].projected.sources[].downwardAPI.items[].fieldRef

Description
必須:Pod のフィールドを選択します。注釈、ラベル、名前、名前空間のみがサポートされます。
タイプ
object
必須
  • fieldPath
Expand
プロパティータイプ説明

apiVersion

string

FieldPath が記述されているスキーマのバージョン。デフォルトは v1 です。

fieldPath

string

指定された API バージョンで選択するフィールドのパス。

19.9.1.76. .spec.config.volumes[].projected.sources[].downwardAPI.items[].resourceFieldRef

Description
コンテナーのリソースを選択します。現在、リソースの制限とリクエスト (limits.cpu、limits.memory、requests.cpu、requests.memory) のみがサポートされています。
タイプ
object
必須
  • resource
Expand
プロパティータイプDescription

containerName

string

コンテナー名: ボリュームには必須、env 変数にはオプション

divisor

integer-or-string

公開されたリソースの出力形式を指定します。デフォルトは 1 です。

resource

string

必須: 選択するリソース

19.9.1.77. .spec.config.volumes[].projected.sources[].secret

Description
プロジェクトする秘密データに関する情報
タイプ
object
Expand
プロパティータイプDescription

items

array

指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームに展開され、名前がキーであり、内容が値になります。指定されている場合、一覧表示されるキーは指定されたパスに展開され、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。

items[]

object

文字列キーをボリューム内のパスにマップします。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

19.9.1.78. .spec.config.volumes[].projected.sources[].secret.items

Description
指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームに展開され、名前がキーであり、内容が値になります。指定されている場合、一覧表示されるキーは指定されたパスに展開され、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
タイプ
array

19.9.1.79. .spec.config.volumes[].projected.sources[].secret.items[]

Description
文字列キーをボリューム内のパスにマップします。
タイプ
object
必須
  • key
  • path
Expand
プロパティータイプDescription

key

string

プロジェクトの鍵。

mode

integer

オプション: このファイルにアクセス許可を設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

キーをマップするファイルの相対パス。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。

19.9.1.80. .spec.config.volumes[].projected.sources[].serviceAccountToken

Description
プロジェクトする serviceAccountToken データに関する情報
タイプ
object
必須
  • path
Expand
プロパティータイプDescription

audience

string

オーディエンスは、トークンの対象オーディエンスです。トークンの受信者は、トークンのオーディエンスで指定された識別子で自分自身を識別する必要があります。そうでない場合は、トークンを拒否する必要があります。対象はデフォルトで API サーバーの識別子に設定されます。

expirationSeconds

integer

ExpirationSeconds は、サービスアカウントトークンの要求された有効期間です。トークンの有効期限が近づくと、kubelet ボリュームプラグインはサービスアカウントトークンをプロアクティブにローテーションします。トークンが存続時間の 80% より古い場合、またはトークンが 24 時間より古い場合、kubelet はトークンのローテーションを開始します。デフォルトは 1 時間で、少なくとも 10 分である必要があります。

path

string

Path は、トークンの展開先となるファイルのマウントポイントに対する相対パスです。

19.9.1.81. .spec.config.volumes[].quobyte

Description
Quobyte は、Pod の有効期限を共有するホストでの Quobyte マウントを表します
タイプ
object
必須
  • レジストリー
  • ボリューム
Expand
プロパティータイプDescription

group

string

ボリュームアクセスをデフォルトにマップするグループはグループではありません

readOnly

boolean

ここでの読み取り専用は、Quobyte ボリュームを読み取り専用のアクセス許可で強制的にマウントします。デフォルトは false です。

レジストリー

string

レジストリーは、ボリュームの中央レジストリーとして機能する host:port ペア (複数のエントリーはコンマで区切られます) として文字列として指定された単一または複数の Quobyte レジストリーサービスを表します

tenant

string

バックエンドで特定の Quobyte ボリュームを所有しているテナント動的にプロビジョニングされた Quobyte ボリュームで使用され、値はプラグインによって設定されます

user

string

ボリュームアクセスをデフォルトにマップするユーザーから serivceaccount ユーザー

ボリューム

string

ボリュームは、すでに作成されているクオバイトボリュームを名前で参照する文字列です。

19.9.1.82. .spec.config.volumes[].rbd

Description
RBD は、Pod の有効期間を共有するホストの Rados ブロックデバイスマウントを表します。詳細: https://examples.k8s.io/volumes/rbd/README.md
タイプ
object
必須
  • image
  • monitors
Expand
プロパティータイプDescription

fsType

string

マウントするボリュームのファイルシステムタイプ。ヒント: ファイルシステムタイプがホストオペレーティングシステムでサポートされていることを確認してください。例:ext4、xfs、ntfs。指定されていない場合、暗黙的に ext4 であると推測されます。詳細: https://kubernetes.io/docs/concepts/storage/volumes#rbd TODO: ファイルシステムのエラーによるマシンの侵害を防ぐにはどうすればよいですか ?

image

string

rados イメージ名。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

keyring

string

キーリングは、RBDUser のキーリングへのパスです。デフォルトは/etc/ceph/keyring です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

monitors

array (string)

Ceph Monitor のコレクション。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

pool

string

rados プール名。デフォルトは rbd です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

readOnly

boolean

ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。デフォルトは false です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

secretRef

object

SecretRef は、RBDUser の認証シークレットの名前です。提供されている場合、キーリングをオーバーライドします。デフォルトは nil です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

user

string

rados ユーザー名。これにより、プール内にイメージを作成できます。 デフォルトは admin です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

19.9.1.83. .spec.config.volumes[].rbd.secretRef

Description
SecretRef は、RBDUser の認証シークレットの名前です。提供されている場合、キーリングをオーバーライドします。デフォルトは nil です。詳細: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
タイプ
object
Expand
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

19.9.1.84. .spec.config.volumes[].scaleIO

Description
ScaleIO は、Kubernetes ノードに接続およびマウントされた ScaleIO 永続ボリュームを表します。
タイプ
object
必須
  • gateway
  • secretRef
  • system
Expand
プロパティータイプDescription

fsType

string

マウントするファイルシステムタイプ。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。元。ext4、xfs、ntfs。デフォルトは xfs です。

gateway

string

ScaleIOAPI ゲートウェイのホストアドレス。

protectionDomain

string

設定されたストレージの ScaleIO 保護ドメインの名前。

readOnly

boolean

デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

secretRef

object

SecretRef は、ScaleIO ユーザーおよびその他の機密情報の秘密を参照します。これが指定されていない場合、ログイン操作は失敗します。

sslEnabled

boolean

ゲートウェイとの SSL 通信を有効/無効にするフラグ、デフォルトは false

storageMode

string

ボリュームのストレージを ThickProvisioned にするか ThinProvisioned にするかを示します。デフォルトは ThinProvisioned です。

storagePool

string

保護ドメインに関連付けられた ScaleIO ストレージプール。

system

string

ScaleIO で設定されたストレージシステムの名前。

volumeName

string

このボリュームソースに関連付けられている、ScaleIO システムですでに作成されているボリュームの名前。

19.9.1.85. .spec.config.volumes[].scaleIO.secretRef

Description
SecretRef は、ScaleIO ユーザーおよびその他の機密情報の秘密を参照します。これが指定されていない場合、ログイン操作は失敗します。
タイプ
object
Expand
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

19.9.1.86. .spec.config.volumes[].secret

Description
シークレットは、このボリュームに入力する必要があるシークレットを表します。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret
タイプ
object
Expand
プロパティータイプDescription

defaultMode

integer

必要に応じて、デフォルトで作成されたファイルでパーミッションを設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。デフォルトは 0644 に設定されます。パス内のディレクトリーはこの設定の影響を受けません。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

items

array

指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームに展開され、名前がキーであり、内容が値になります。指定されている場合、一覧表示されるキーは指定されたパスに展開され、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。

items[]

object

文字列キーをボリューム内のパスにマップします。

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

secretName

string

使用する Pod の namespace のシークレット名。詳細: https://kubernetes.io/docs/concepts/storage/volumes#secret

19.9.1.87. .spec.config.volumes[].secret.items

Description
指定されていない場合、参照されるシークレットの Data フィールドのそれぞれのキーと値のペアはボリュームに展開され、名前がキーであり、内容が値になります。指定されている場合、一覧表示されるキーは指定されたパスに展開され、リストされていないキーはありません。シークレットに存在しないキーが指定された場合、ボリュームのセットアップはオプションとしてマークされない限りエラーになります。パスは相対する必要があり、'..' パスが含まれないか、または '..' で始まる場合があります。
タイプ
array

19.9.1.88. .spec.config.volumes[].secret.items[]

Description
文字列キーをボリューム内のパスにマップします。
タイプ
object
必須
  • key
  • path
Expand
プロパティータイプDescription

key

string

プロジェクトの鍵。

mode

integer

オプション: このファイルにアクセス許可を設定するために使用されるモードビット。0000 から 0777 の 8 進数値、または 0 から 511 までの 10 進数の値である必要があります。YAML は 8 進数および 10 進数値の両方を受け入れます。JSON にはモードビットに 10 進数の値が必要です。指定しない場合、ボリューム defaultMode が使用されます。これは fsGroup などのファイルモードに影響する他のオプションと競合する可能性があり、その結果は他のモードビットセットである可能性があります。

path

string

キーをマップするファイルの相対パス。絶対的なパスではない可能性があります。パス要素 '..' を含めることはできません。文字列 '..' で始まらない場合があります。

19.9.1.89. .spec.config.volumes[].storageos

Description
StorageOS は、Kubernetes ノードに接続およびマウントされた StorageOS ボリュームを表します。
タイプ
object
Expand
プロパティータイプDescription

fsType

string

マウントするファイルシステムタイプ。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。元。ext4、xfs、ntfs。指定されていない場合、暗黙的に ext4 であると推測されます。

readOnly

boolean

デフォルトは false (読み取り/書き込み) です。ここで ReadOnly を指定すると、VolumeMounts で ReadOnly 設定が強制的に実行されます。

secretRef

object

SecretRef は、StorageOSAPI クレデンシャルを取得するために使用するシークレットを指定します。指定しない場合、デフォルト値が試行されます。

volumeName

string

VolumeName は、人間が読める形式の StorageOS ボリュームの名前です。ボリューム名は、ネームスペース内でのみ一意です。

volumeNamespace

string

VolumeNamespace は、StorageOS 内のボリュームのスコープを指定します。名前空間が指定されていない場合は、Pod の名前空間が使用されます。これにより、Kubernetes の名前スコープを StorageOS 内にミラーリングして、より緊密に統合することができます。VolumeName を任意の名前に設定して、デフォルトの動作をオーバーライドします。StorageOS 内で名前空間を使用していない場合は、デフォルトに設定します。StorageOS 内に事前に存在しない名前空間が作成されます。

19.9.1.90. .spec.config.volumes[].storageos.secretRef

Description
SecretRef は、StorageOSAPI クレデンシャルを取得するために使用するシークレットを指定します。指定しない場合、デフォルト値が試行されます。
タイプ
object
Expand
プロパティータイプ説明

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

19.9.1.91. .spec.config.volumes[].vsphereVolume

Description
VsphereVolume は、kubelet ホストマシンに接続およびマウントされた vSphere ボリュームを表します。
タイプ
object
必須
  • volumePath
Expand
プロパティータイプDescription

fsType

string

マウントするファイルシステムタイプ。ホストオペレーティングシステムでサポートされているファイルシステムタイプである必要があります。元。ext4、xfs、ntfs。指定されていない場合、暗黙的に ext4 であると推測されます。

storagePolicyID

string

StoragePolicyName に関連付けられたストレージポリシーベースの管理 (SPBM) プロファイル ID。

storagePolicyName

string

ストレージポリシーベースの管理 (SPBM) プロファイル名。

volumePath

string

vSphere ボリューム vmdk を識別するパス

19.9.1.92. .status

Description
タイプ
object
必須
  • lastUpdated
Expand
プロパティータイプDescription

catalogHealth

array

CatalogHealth には、関連する CatalogSources のステータスに関するサブスクリプションのビューが含まれています。これは、CatalogSources に関連する SubscriptionStatusConditions を決定するために使用されます。

catalogHealth[]

object

SubscriptionCatalogHealth は、サブスクリプションが認識している CatalogSource の状態を記述します。

conditions

array

条件は、サブスクリプションの現在の状態に関する最新の利用可能な観測のリストです。

conditions[]

object

SubscriptionCondition は、サブスクリプションの状態について利用可能な最新の観測値を表します。

currentCSV

string

CurrentCSV は、サブスクリプションが進行中の CSV です。

installPlanGeneration

integer

InstallPlanGeneration は、現在の世代のインストールプランです。

installPlanRef

object

InstallPlanRef は、サブスクリプションの現在の CSV を含む最新の InstallPlan への参照です。

installedCSV

string

InstalledCSV は、サブスクリプションによって現在インストールされている CSV です。

installplan

object

インストールは、サブスクリプション用に生成された最新の InstallPlan への参照です。非推奨:InstallPlanRef

lastUpdated

string

LastUpdated は、サブスクリプションステータスが最後に更新された時刻を表します。

reason

string

理由は、サブスクリプションが現在の状態に移行した理由です。

state

string

状態は、サブスクリプションの現在の状態を表します

19.9.1.93. .status.catalogHealth

Description
CatalogHealth には、関連する CatalogSources のステータスに関するサブスクリプションのビューが含まれています。これは、CatalogSources に関連する SubscriptionStatusConditions を決定するために使用されます。
タイプ
array

19.9.1.94. .status.catalogHealth[]

Description
SubscriptionCatalogHealth は、サブスクリプションが認識している CatalogSource の状態を記述します。
タイプ
object
必須
  • catalogSourceRef
  • healthy
  • lastUpdated
Expand
プロパティータイプDescription

catalogSourceRef

object

CatalogSourceRef は、CatalogSource への参照です。

healthy

ブール値

CatalogSource が正常である場合、正常は真です。それ以外の場合は false。

lastUpdated

string

LastUpdated は、CatalogSourceHealth が最後に変更された時刻を表します

19.9.1.95. .status.catalogHealth[].catalogSourceRef

Description
CatalogSourceRef は、CatalogSource への参照です。
タイプ
object
Expand
プロパティータイプ説明

apiVersion

string

参照先の API バージョン。

fieldPath

string

オブジェクト全体ではなく一部を参照する場合に、この文字列には、desiredState.manifest.containers[2] など、有効な JSON/Go フィールドアクセスステートメントを含める必要があります。たとえば、オブジェクトの参照先が Pod 内のコンテナーの場合には、spec.containers{name} などの値に設定されます (name はイベントをトリガーしたコンテナー名に置き換えます)。またはコンテナー名が指定されていない場合には、spec.containers[2] の値に設定されます (この Pod 内でインデックス が 2 のコンテナー)。この構文が選択された唯一の理由は、オブジェクトの一部の参照を明確に定義するためです。TODO: この設計は最終版ではないので今後このフィールドは変更される可能性があります。

kind

string

参照先の種類。詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

namespace

string

参照先の namespace。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

この参照が作成される特定の resourceVersion (ある場合)。詳細: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

参照先の UID。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

19.9.1.96. .status.conditions

Description
条件は、サブスクリプションの現在の状態に関する最新の利用可能な観測のリストです。
タイプ
array

19.9.1.97. .status.conditions[]

Description
SubscriptionCondition は、サブスクリプションの状態について利用可能な最新の観測値を表します。
タイプ
object
必須
  • status
  • type
Expand
プロパティータイプDescription

lastHeartbeatTime

string

LastHeartbeatTime は、特定の条件で更新を取得した最後の時間です

lastTransitionTime

string

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。

message

string

Message は、最後の遷移に関する詳細を示す人間が判読できるメッセージです。

reason

string

Reason は、条件の最後の遷移の 1 ワードの CamelCase 理由です。

status

string

ステータスは、条件のステータスであり、True、False、Unknown のいずれかです。

type

string

タイプは、サブスクリプション条件のタイプです。

19.9.1.98. .status.installPlanRef

Description
InstallPlanRef は、サブスクリプションの現在の CSV を含む最新の InstallPlan への参照です。
タイプ
object
Expand
プロパティータイプ説明

apiVersion

string

参照先の API バージョン。

fieldPath

string

オブジェクト全体ではなく一部を参照する場合に、この文字列には、desiredState.manifest.containers[2] など、有効な JSON/Go フィールドアクセスステートメントを含める必要があります。たとえば、オブジェクトの参照先が Pod 内のコンテナーの場合には、spec.containers{name} などの値に設定されます (name はイベントをトリガーしたコンテナー名に置き換えます)。またはコンテナー名が指定されていない場合には、spec.containers[2] の値に設定されます (この Pod 内でインデックス が 2 のコンテナー)。この構文が選択された唯一の理由は、オブジェクトの一部の参照を明確に定義するためです。TODO: この設計は最終版ではないので今後このフィールドは変更される可能性があります。

kind

string

参照先の種類。詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

namespace

string

参照先の namespace。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

この参照が作成される特定の resourceVersion (ある場合)。詳細: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

参照先の UID。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

19.9.1.99. .status.installplan

Description
インストールは、サブスクリプション用に生成された最新の InstallPlan への参照です。非推奨:InstallPlanRef
タイプ
object
必須
  • apiVersion
  • kind
  • name
  • uuid
Expand
プロパティータイプ説明

apiVersion

string

 

kind

string

 

name

string

 

uuid

string

UID は、UUID を含む一意の ID 値を保持するタイプです。UUID のみを使用するわけではないため、これは文字列のエイリアスです。タイプであることは意図を捉え、UID と名前が混同されないようにするのに役立ちます。

19.9.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/operators.coreos.com/v1alpha1/subscriptions

    • GET: サブスクリプションの種類のオブジェクトを一覧表示します
  • /apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/subscriptions

    • 削除: サブスクリプションのコレクションを削除します
    • GET: サブスクリプションの種類のオブジェクトを一覧表示します
    • POST: サブスクリプションを作成します
  • /apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/subscriptions/{name}

    • 削除: サブスクリプションを削除します
    • GET: 指定されたサブスクリプションを読み取ります
    • PATCH: 指定されたサブスクリプションを部分的に更新します
    • PUT: 指定されたサブスクリプションを置き換えます
  • /apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/subscriptions/{name}/status

    • GET: 指定されたサブスクリプションのステータスを読み取ります
    • PATCH: 指定されたサブスクリプションのステータスを部分的に更新します
    • PUT: 指定されたサブスクリプションのステータスを置き換えます

19.9.2.1. /apis/operators.coreos.com/v1alpha1/subscriptions

Expand
表19.212 グローバルクエリーパラメーター
パラメータータイプ説明

allowWatchBookmarks

boolean

allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの裁量で送信されます。クライアントは、ブックマークが特定の間隔で返されると想定したり、サーバーがセッション中に BOOKMARK イベントを送信すると想定したりすることはできません。これが watch でない場合には、このフィールドは無視されます。

continue

string

サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で前のクエリー結果からの continue 値のみを使用でき、サーバーは認識しない continue 値を拒否できます。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合、続行フィールドなしでリストを再起動する必要があります。そうしないと、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信する可能性があり、サーバーは次のキーから始まるリストで応答しますが、前のリスト結果と矛盾する最新のスナップショットから - 作成されたオブジェクト、変更、または削除された後、最初のリストリクエストは、それらのキーが次のキーの後にある限り、応答に含まれます。

watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。

fieldSelector

string

返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトはすべてです。

labelSelector

string

返されるオブジェクトのリストをラベルで制限するためのセレクターです。デフォルトはすべてです。

limit

integer

limit は、リスト呼び出しに対して返される応答の最大数です。さらにアイテムが存在する場合、サーバーはリストメタデータの continue フィールドを、同じ初期クエリーで使用して次の結果セットを取得できる値に設定します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしないことを選択でき、利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。

サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、制限を使用して非常に大きな結果の小さなチャンクを受信するクライアントが、すべての可能なオブジェクトを確実に表示できるようにします。チャンクリスト中にオブジェクトが更新された場合、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。

pretty

string

'true' の場合、出力はきれいに印刷されます。

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

resourceVersionMatch

string

resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することを強くお勧めします。詳細については、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

timeoutSeconds

integer

リスト/ウォッチコールのタイムアウト。これにより、アクティビティーまたは非アクティブに関係なく、通話時間が制限されます。

watch

boolean

説明されているリソースへの変更を監視し、それらを追加、更新、および削除の通知のストリームとして返します。resourceVersion を指定します。

HTTP メソッド
GET
Description
サブスクリプションの種類のオブジェクトを一覧表示します
Expand
表19.213 HTTP 応答
HTTP コードレスポンス本文

200 - OK

SubscriptionList スキーマ

401 - Unauthorized

空白

19.9.2.2. /apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/subscriptions

Expand
表19.214 グローバルパスパラメーター
パラメータータイプ説明

namespace

string

チームやプロジェクトなどのオブジェクト名と認証スコープ

Expand
表19.215 グローバルクエリーパラメーター
パラメータータイプ説明

pretty

string

'true' の場合、出力はきれいに印刷されます。

HTTP メソッド
DELETE
Description
サブスクリプションのコレクションを削除する
Expand
表19.216 クエリーパラメーター
パラメータータイプ説明

allowWatchBookmarks

boolean

allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの裁量で送信されます。クライアントは、ブックマークが特定の間隔で返されると想定したり、サーバーがセッション中に BOOKMARK イベントを送信すると想定したりすることはできません。これが watch でない場合には、このフィールドは無視されます。

continue

string

サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で前のクエリー結果からの continue 値のみを使用でき、サーバーは認識しない continue 値を拒否できます。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合、続行フィールドなしでリストを再起動する必要があります。そうしないと、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信する可能性があり、サーバーは次のキーから始まるリストで応答しますが、前のリスト結果と矛盾する最新のスナップショットから - 作成されたオブジェクト、変更、または削除された後、最初のリストリクエストは、それらのキーが次のキーの後にある限り、応答に含まれます。

watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。

fieldSelector

string

返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトはすべてです。

labelSelector

string

返されるオブジェクトのリストをラベルで制限するためのセレクターです。デフォルトはすべてです。

limit

integer

limit は、リスト呼び出しに対して返される応答の最大数です。さらにアイテムが存在する場合、サーバーはリストメタデータの continue フィールドを、同じ初期クエリーで使用して次の結果セットを取得できる値に設定します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしないことを選択でき、利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。

サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、制限を使用して非常に大きな結果の小さなチャンクを受信するクライアントが、すべての可能なオブジェクトを確実に表示できるようにします。チャンクリスト中にオブジェクトが更新された場合、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

resourceVersionMatch

string

resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することを強くお勧めします。詳細については、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

timeoutSeconds

integer

リスト/ウォッチコールのタイムアウト。これにより、アクティビティーまたは非アクティブに関係なく、通話時間が制限されます。

watch

boolean

説明されているリソースへの変更を監視し、それらを追加、更新、および削除の通知のストリームとして返します。resourceVersion を指定します。

Expand
表19.217 HTTP 応答
HTTP コードレスポンス本文

200 - OK

Status_v2 schema

401 - Unauthorized

空白

HTTP メソッド
GET
Description
サブスクリプションの種類のオブジェクトを一覧表示します
Expand
表19.218 クエリーパラメーター
パラメータータイプ説明

allowWatchBookmarks

boolean

allowWatchBookmarks は、タイプが BOOKMARK の監視イベントを要求します。ブックマークを実装していないサーバーはこのフラグを無視する可能性があり、ブックマークはサーバーの裁量で送信されます。クライアントは、ブックマークが特定の間隔で返されると想定したり、サーバーがセッション中に BOOKMARK イベントを送信すると想定したりすることはできません。これが watch でない場合には、このフィールドは無視されます。

continue

string

サーバーからさらに結果を取得する場合は、continue オプションを設定する必要があります。この値はサーバー定義であるため、クライアントは同じクエリーパラメーター (continue の値を除く) で前のクエリー結果からの continue 値のみを使用でき、サーバーは認識しない continue 値を拒否できます。指定された continue の値が有効期限切れ (通常 5-15 分) やサーバーでの設定変更により無効となった場合、サーバーは 410 ResourceExpired エラーと continue トークンを返します。クライアントが一貫性のあるリストを必要とする場合、続行フィールドなしでリストを再起動する必要があります。そうしないと、クライアントは 410 エラーで受信したトークンを使用して別のリスト要求を送信する可能性があり、サーバーは次のキーから始まるリストで応答しますが、前のリスト結果と矛盾する最新のスナップショットから - 作成されたオブジェクト、変更、または削除された後、最初のリストリクエストは、それらのキーが次のキーの後にある限り、応答に含まれます。

watch が true の場合、このフィールドはサポートされません。クライアントは、サーバーから返された最後の resourceVersion 値から監視を開始し、変更を見逃すことはありません。

fieldSelector

string

返されるオブジェクトのリストをフィールドごとに制限するセレクター。デフォルトはすべてです。

labelSelector

string

返されるオブジェクトのリストをラベルで制限するためのセレクターです。デフォルトはすべてです。

limit

integer

limit は、リスト呼び出しに対して返される応答の最大数です。さらにアイテムが存在する場合、サーバーはリストメタデータの continue フィールドを、同じ初期クエリーで使用して次の結果セットを取得できる値に設定します。制限を設定すると、要求されたすべてのオブジェクトが除外された場合に、要求された量より少ないアイテム (最大 0 個のアイテム) が返される場合があります。クライアントは、続行フィールドの存在のみを使用して、より多くの結果が利用可能かどうかを判断する必要があります。サーバーは limit 引数をサポートしないことを選択でき、利用可能なすべての結果を返します。制限が指定され、続行フィールドが空の場合、クライアントはこれ以上結果が利用できないと想定する場合があります。watch が true の場合、このフィールドはサポートされません。

サーバーは、continue を使用したときに返されるオブジェクトが、制限なしで単一のリスト呼び出しを発行するのと同じであることを保証します。つまり、最初の要求が発行された後に作成、変更、または削除されたオブジェクトは、後続の継続要求に含まれません。これは、一貫性のあるスナップショットと呼ばれることもあり、制限を使用して非常に大きな結果の小さなチャンクを受信するクライアントが、すべての可能なオブジェクトを確実に表示できるようにします。チャンクリスト中にオブジェクトが更新された場合、最初のリスト結果が計算されたときに存在していたオブジェクトのバージョンが返されます。

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

resourceVersionMatch

string

resourceVersionMatch は、resourceVersion をリスト呼び出しに適用する方法を決定します。resourceVersion が設定されているリスト呼び出しには resourceVersionMatch を設定することを強くお勧めします。詳細については、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

timeoutSeconds

integer

リスト/ウォッチコールのタイムアウト。これにより、アクティビティーまたは非アクティブに関係なく、通話時間が制限されます。

watch

boolean

説明されているリソースへの変更を監視し、それらを追加、更新、および削除の通知のストリームとして返します。resourceVersion を指定します。

Expand
表19.219 HTTP 応答
HTTP コードレスポンス本文

200 - OK

SubscriptionList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
Description
サブスクリプションの作成
Expand
表19.220 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

Expand
表19.221 ボディパラメーター
パラメータータイプ説明

ボディー

サブスクリプション スキーマ

 
Expand
表19.222 HTTP 応答
HTTP コードレスポンス本文

200 - OK

サブスクリプション スキーマ

201 - Created

サブスクリプション スキーマ

202 - Accepted

サブスクリプション スキーマ

401 - Unauthorized

空白

19.9.2.3. /apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/subscriptions/{name}

Expand
表19.223 グローバルパスパラメーター
パラメータータイプ説明

name

string

サブスクリプションの名前。

namespace

string

チームやプロジェクトなどのオブジェクト名と認証スコープ

Expand
表19.224 グローバルクエリーパラメーター
パラメータータイプ説明

pretty

string

'true' の場合、出力はきれいに印刷されます。

HTTP メソッド
DELETE
Description
サブスクリプションの削除
Expand
表19.225 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

gracePeriodSeconds

integer

オブジェクトが削除されるまでの時間 (秒)。値は負の値ではない整数にする必要があります。値をゼロに指定すると、ただちに削除されます。この値が nil の場合、指定されたタイプのデフォルトの猶予期間が使用されます。指定しない場合、デフォルトでオブジェクトごとの値になります。ゼロはすぐに削除することを意味します。

orphanDependents

boolean

非推奨: PropagationPolicy を使用してください。このフィールドは 1.7 で非推奨となります。依存オブジェクトが孤立している必要があります。true/false の場合、孤立したファイナライザーがオブジェクトのファイナライザー一覧で追加/削除されます。このフィールドまたは PropagationPolicy のいずれかを設定できますが、両方を設定することはできません。

propagationPolicy

string

ガベージコレクションが実行されるかどうか、およびその方法。このフィールドまたは OrphanDependents のどちらかを設定できますが、両方を設定することはできません。デフォルトポリシーは、metadata.finalizers に設定されている既存のファイナライザーとリソース固有のデフォルトポリシーによって決定されます。許容値は次のとおりです。'Orphan' - 依存を削除して孤立させます。'Background' - ガベージコレクターがバックグラウンドで依存関係を削除できるようにします。'Foreground' - フォアグラウンド内のすべての依存関係を削除するカスケードポリシー。

Expand
表19.226 ボディパラメーター
パラメータータイプ説明

body

DeleteOptions_v2 schema

 
Expand
表19.227 HTTP 応答
HTTP コードレスポンス本文

200 - OK

Status_v2 schema

202 - Accepted

Status_v2 schema

401 - Unauthorized

空白

HTTP メソッド
GET
Description
指定されたサブスクリプションを読む
Expand
表19.228 クエリーパラメーター
パラメータータイプ説明

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

Expand
表19.229 HTTP 応答
HTTP コードレスポンス本文

200 - OK

サブスクリプション スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
Description
指定されたサブスクリプションを部分的に更新します
Expand
表19.230 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

Expand
表19.231 ボディパラメーター
パラメータータイプ説明

body

Patch schema

 
Expand
表19.232 HTTP 応答
HTTP コードレスポンス本文

200 - OK

サブスクリプション スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
Description
指定されたサブスクリプションを置き換えます
Expand
表19.233 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

Expand
表19.234 ボディパラメーター
パラメータータイプ説明

ボディー

サブスクリプション スキーマ

 
Expand
表19.235 HTTP 応答
HTTP コードレスポンス本文

200 - OK

サブスクリプション スキーマ

201 - Created

サブスクリプション スキーマ

401 - Unauthorized

空白

19.9.2.4. /apis/operators.coreos.com/v1alpha1/namespaces/{namespace}/subscriptions/{name}/status

Expand
表19.236 グローバルパスパラメーター
パラメータータイプ説明

name

string

サブスクリプションの名前。

namespace

string

チームやプロジェクトなどのオブジェクト名と認証スコープ

Expand
表19.237 グローバルクエリーパラメーター
パラメータータイプ説明

pretty

string

'true' の場合、出力はきれいに印刷されます。

HTTP メソッド
GET
Description
指定されたサブスクリプションのステータスを読み取ります
Expand
表19.238 クエリーパラメーター
パラメータータイプ説明

resourceVersion

string

resourceVersion は、リクエストが提供される可能性のあるリソースバージョンに制約を設定します。詳細は、https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions を参照してください。

Defaults to unset

Expand
表19.239 HTTP 応答
HTTP コードレスポンス本文

200 - OK

サブスクリプション スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
Description
指定されたサブスクリプションのステータスを部分的に更新します
Expand
表19.240 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

Expand
表19.241 ボディパラメーター
パラメータータイプ説明

body

Patch schema

 
Expand
表19.242 HTTP 応答
HTTP コードレスポンス本文

200 - OK

サブスクリプション スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
Description
指定されたサブスクリプションのステータスを置き換えます
Expand
表19.243 クエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

Expand
表19.244 ボディパラメーター
パラメータータイプ説明

ボディー

サブスクリプション スキーマ

 
Expand
表19.245 HTTP 応答
HTTP コードレスポンス本文

200 - OK

サブスクリプション スキーマ

201 - Created

サブスクリプション スキーマ

401 - Unauthorized

空白

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat