マルチクラスタとVerrazzanoプロジェクト

パッケージ:

clusters.verrazzano.io/v1alpha1

リソース・タイプ:

MultiClusterApplicationConfiguration

MultiClusterApplicationConfigurationは、マルチクラスタ・アプリケーションAPIを指定します。

フィールド 説明
apiVersion
string		 clusters.verrazzano.io/v1alpha1
kind
string 		MultiClusterApplicationConfiguration
metadata
Kubernetes meta/v1.ObjectMeta 		metadataフィールドのフィールドについては、Kubernetes APIのドキュメントを参照してください。
spec
MultiClusterApplicationConfigurationSpec

マルチクラスタ・アプリケーション・リソースの目的の状態。



placement
Placement

アプリケーションを作成するクラスタ。
secrets
[]string 		(オプション)

アプリケーションで使用されるシークレットのリスト。これらのシークレットは、MultiClusterApplicationConfigurationリソースをデプロイする前に、アプリケーションのネームスペースに作成する必要があります。
template
ApplicationConfigurationTemplate

OAM applicationConfigurationリソースのメタデータおよび仕様を含むテンプレート。
status
MultiClusterResourceStatus

マルチクラスタ・アプリケーション・リソースの観測された状態。

MultiClusterComponent

MultiClusterComponentは、MultiClusterコンポーネントAPIを指定します。

フィールド 説明
apiVersion
string		 clusters.verrazzano.io/v1alpha1
kind
string 		MultiClusterComponent
metadata
Kubernetes meta/v1.ObjectMeta 		metadataフィールドのフィールドについては、Kubernetes APIのドキュメントを参照してください。
spec
MultiClusterComponentSpec

MultiClusterコンポーネント・リソースの目的の状態。



placement
Placement

コンポーネントを作成するクラスタ。
template
ComponentTemplate

OAMコンポーネントのメタデータおよび仕様を含むテンプレート。
status
MultiClusterResourceStatus

MultiClusterコンポーネント・リソースの観測された状態。

MultiClusterConfigMap

MultiClusterConfigMapは、MultiCluster ConfigMap APIを指定します。

フィールド 説明
apiVersion
string		 clusters.verrazzano.io/v1alpha1
kind
string 		MultiClusterConfigMap
metadata
Kubernetes meta/v1.ObjectMeta 		metadataフィールドのフィールドについては、Kubernetes APIのドキュメントを参照してください。
spec
MultiClusterConfigMapSpec

MultiCluster ConfigMapリソースの目的の状態。



placement
Placement

ConfigMapを作成するクラスタ。
template
ConfigMapTemplate

埋込みKubernetes ConfigMap。
status
MultiClusterResourceStatus

MultiCluster ConfigMapリソースの観測された状態。

MultiClusterSecret

MultiClusterSecretは、MultiClusterシークレットAPIを指定します。

フィールド 説明
apiVersion
string		 clusters.verrazzano.io/v1alpha1
kind
string 		MultiClusterSecret
metadata
Kubernetes meta/v1.ObjectMeta 		metadataフィールドのフィールドについては、Kubernetes APIのドキュメントを参照してください。
spec
MultiClusterSecretSpec

MultiClusterシークレット・リソースの目的の状態。



placement
Placement

シークレットを作成するクラスタ。
template
SecretTemplate

埋込みKubernetesシークレット。
status
MultiClusterResourceStatus

MultiClusterシークレット・リソースの観測された状態。

VerrazzanoProject

VerrazzanoProjectは、VerrazzanoプロジェクトAPIを指定します。

フィールド 説明
apiVersion
string		 clusters.verrazzano.io/v1alpha1
kind
string 		VerrazzanoProject
metadata
Kubernetes meta/v1.ObjectMeta 		metadataフィールドのフィールドについては、Kubernetes APIのドキュメントを参照してください。
spec
VerrazzanoProjectSpec

Verrazzanoプロジェクト・リソースの目的の状態。



placement
Placement

ネームスペースが作成されるクラスタ。
template
ProjectTemplate

プロジェクト・テンプレート。
status
MultiClusterResourceStatus

Verrazzanoプロジェクト・リソースの観測された状態。

ApplicationConfigurationTemplate

(出現場所:MultiClusterApplicationConfigurationSpec)

ApplicationConfigurationTemplateには、OAM applicationConfigurationリソースのメタデータと埋込み仕様があります。

フィールド 説明
metadata
EmbeddedObjectMeta

アプリケーションを説明するメタデータ。
spec
OAM core/v1alpha2.ApplicationConfigurationSpec

埋込みOAMアプリケーション仕様。



components
[]OAM core/v1alpha2.ApplicationConfigurationComponent

このApplicationConfigurationを構成するコンポーネント。各コンポーネントはワークロードのインスタンス化に使用されます。

Cluster

(出現場所:Placement)

Clusterには、単一クラスタの名前が含まれます。

フィールド 説明
name
string

このクラスタの名前。

ClusterLevelStatus

(出現場所:MultiClusterResourceStatus)

ClusterLevelStatusは、特定のクラスタ内のマルチクラスタ・リソースのステータスを示します。

フィールド 説明
lastUpdateTime
string

このクラスタのリソース状態の最終更新時刻。
message
string

このクラスタのステータスに関する詳細を示すメッセージ。
name
string

クラスタの名前。
state
StateType

このクラスタ内のリソースの状態。

ComponentTemplate

(出現場所:MultiClusterComponentSpec)

ComponentTemplateには、OAMコンポーネントのメタデータおよび埋込み仕様があります。

フィールド 説明
metadata
EmbeddedObjectMeta

コンポーネントを説明するメタデータ。
spec
OAM core/v1alpha2.ComponentSpec

埋込みOAMコンポーネント仕様。



workload
Kubernetes runtime.RawExtension

このコンポーネントを含むApplicationConfigurationごとに作成されるワークロード。ワークロードは、workloadDefinitionのインスタンスです。ワークロードのGVK情報または特別な「type」フィールドを使用して、ワークロードの内容をworkloadDefinitionに関連付けます
parameters
[]OAM core/v1alpha2.ComponentParameter 		(オプション)

このコンポーネントによって公開されるパラメータ。このコンポーネントを参照するApplicationConfigurationsでは、これらのパラメータの値を指定すると、埋込みワークロードに注入されます。

Condition

(出現場所:MultiClusterResourceStatus)

Conditionは、マルチクラスタ・リソースの現在の状態を示します。

フィールド 説明
lastTransitionTime
string 		(オプション)

状態があるステータスから別のステータスに最後に遷移した時間。
message
string 		(オプション)

最後の遷移に関する詳細を示すメッセージ。
status
Kubernetes core/v1.ConditionStatus

条件のステータス: True、FalseまたはUnknownのいずれか。
type
ConditionType

条件のタイプ。

ConditionType (string alias)

(出現場所:Condition)

ConditionTypeは、kubectl waitでチェックできるマルチクラスタ・リソースの条件を識別します。

値 説明

"DeployComplete"

DeployCompleteは、指定されたクラスタへのデプロイメントが正常に完了したことを意味します。

"DeployFailed"

DeployFailedは、指定されたクラスタへのデプロイメントが失敗したことを意味します。

"DeployPending"

DeployPendingは、指定されたクラスタへのデプロイメントが進行中であることを意味します。

ConfigMapTemplate

(出現場所:MultiClusterConfigMapSpec)

ConfigMapTemplateには、Kubernetes ConfigMapのメタデータおよび仕様があります。

フィールド 説明
binaryData
map[string][]byte

types.goで定義されているstruct ConfigMapのbinaryDataフィールドに対応します。
data
map[string]string

types.goで定義されているstruct ConfigMapのdataフィールドに対応します。
immutable
bool

types.goで定義されているstruct ConfigMapのimmutableフィールドに対応します。
metadata
EmbeddedObjectMeta

ConfigMapを説明するメタデータ。

EmbeddedObjectMeta

(出現場所:ApplicationConfigurationTemplate、ComponentTemplate、ConfigMapTemplate、SecretTemplate)

EmbeddedObjectMetaは、リソースを説明するメタデータです。

フィールド 説明
annotations
map[string]string 		(オプション)

リソースの注釈。
labels
map[string]string 		(オプション)

リソースのラベル。
name
string 		(オプション)

リソースの名前。
namespace
string 		(オプション)

リソースのネームスペース。

MultiClusterApplicationConfigurationSpec

(出現場所:MultiClusterApplicationConfiguration)

MultiClusterApplicationConfigurationSpecは、マルチクラスタ・アプリケーションの目的の状態を定義します。

フィールド 説明
placement
Placement

アプリケーションを作成するクラスタ。
secrets
[]string 		(オプション)

アプリケーションで使用されるシークレットのリスト。これらのシークレットは、MultiClusterApplicationConfigurationリソースをデプロイする前に、アプリケーションのネームスペースに作成する必要があります。
template
ApplicationConfigurationTemplate

OAM applicationConfigurationリソースのメタデータおよび仕様を含むテンプレート。

MultiClusterComponentSpec

(出現場所:MultiClusterComponent)

MultiClusterComponentSpecは、MultiClusterコンポーネントの目的の状態を定義します。

フィールド 説明
placement
Placement

コンポーネントを作成するクラスタ。
template
ComponentTemplate

OAMコンポーネントのメタデータおよび仕様を含むテンプレート。

MultiClusterConfigMapSpec

(出現場所:MultiClusterConfigMap)

MultiClusterConfigMapSpecは、MultiCluster ConfigMapの目的の状態を定義します。

フィールド 説明
placement
Placement

ConfigMapを作成するクラスタ。
template
ConfigMapTemplate

埋込みKubernetes ConfigMap。

MultiClusterResourceStatus

(出現場所:MultiClusterApplicationConfiguration、MultiClusterComponent、MultiClusterConfigMap、MultiClusterSecret、VerrazzanoProject)

MultiClusterResourceStatusは、マルチクラスタ・リソースの実行時ステータスです。

フィールド 説明
clusters
[]ClusterLevelStatus

各クラスタのステータス情報。
conditions
[]Condition

マルチクラスタ・リソースの現在の状態。
state
StateType

マルチクラスタ・リソースの状態。状態値は大/小文字が区別され、次のように書式設定されます:

  • Failed: クラスタへのデプロイメントが失敗しました
  • Pending: クラスタへのデプロイメントが進行中です
  • Succeeded: クラスタへのデプロイメントが正常に完了しました

MultiClusterSecretSpec

(出現場所:MultiClusterSecret)

MultiClusterSecretSpecは、MultiClusterシークレットの目的の状態を定義します。

フィールド 説明
placement
Placement

シークレットを作成するクラスタ。
template
SecretTemplate

埋込みKubernetesシークレット。

NamespaceTemplate

(出現場所:ProjectTemplate)

NamespaceTemplateには、Kubernetesネームスペースのメタデータおよび仕様が含まれています。

フィールド 説明
metadata
Kubernetes meta/v1.ObjectMeta 		(オプション) metadataフィールドのフィールドについては、Kubernetes APIのドキュメントを参照してください。
spec
Kubernetes core/v1.NamespaceSpec

ネームスペースの仕様。



finalizers
[]Kubernetes core/v1.FinalizerName 		(オプション)

ファイナライザは、オブジェクトをストレージから完全に削除するために空にする必要がある値の不透明リストです。詳細情報: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/

NetworkPolicyTemplate

(出現場所:ProjectTemplate)

NetworkPolicyTemplateには、Kubernetes NetworkPolicyのメタデータおよび仕様が含まれています。

フィールド 説明
metadata
Kubernetes meta/v1.ObjectMeta 		(オプション) metadataフィールドのフィールドについては、Kubernetes APIのドキュメントを参照してください。
spec
Kubernetes networking/v1.NetworkPolicySpec

ネットワーク・ポリシーの仕様。



podSelector
Kubernetes meta/v1.LabelSelector

このNetworkPolicyオブジェクトが適用されるポッドを選択します。イングレス・ルールの配列は、このフィールドで選択したポッドに適用されます。複数のネットワーク・ポリシーで同じポッド・セットを選択できます。この場合、それぞれのイングレス・ルールは付加的に結合されます。このフィールドはオプションではなく、標準のラベル・セレクタ・セマンティクスに従います。空のpodSelectorは、このネームスペース内のすべてのポッドと一致します。
ingress
[]Kubernetes networking/v1.NetworkPolicyIngressRule 		(オプション)

選択したポッドに適用されるイングレス・ルールのリスト。ポッドを選択するNetworkPoliciesがない場合(およびクラスタ・ポリシーでトラフィックが許可されている場合)、またはトラフィック・ソースがポッドのローカル・ノードである場合、またはポッドと一致するpodSelectorを持つすべてのNetworkPolicyオブジェクトで少なくとも1つのイングレス・ルールにトラフィックが一致する場合、ポッドへのトラフィックが許可されます。このフィールドが空の場合、このNetworkPolicyではトラフィックが許可されません(また、選択したポッドがデフォルトで確実に分離されるようにするためにのみ機能します)
egress
[]Kubernetes networking/v1.NetworkPolicyEgressRule 		(オプション)

選択したポッドに適用されるエグレス・ルールのリスト。ポッドを選択するNetworkPoliciesがない場合(およびクラスタ・ポリシーでトラフィックが許可されている場合)、またはポッドと一致するpodSelectorを持つすべてのNetworkPolicyオブジェクトで少なくとも1つのエグレス・ルールにトラフィックが一致する場合、送信トラフィックは許可されます。このフィールドが空の場合、このNetworkPolicyではすべての送信トラフィックが制限されます(また、選択したポッドがデフォルトで確実に分離されるようにするためにのみ機能します)このフィールドは1.8のベータレベルです
policyTypes
[]Kubernetes networking/v1.PolicyType 		(オプション)

NetworkPolicyが関連するルール・タイプのリスト。有効なオプションは、[“Ingress”]、[“Egress”]、または[“Ingress”, “Egress”]です。このフィールドを指定しない場合は、イングレス・ルールまたはエグレス・ルールの存在に基づいてデフォルト設定されます。エグレス・セクションを含むポリシーはエグレスに影響すると想定され、すべてのポリシー(イングレス・セクションを含むかどうかは問わない)はイングレスに影響すると想定されます。エグレスのみのポリシーを記述する場合は、policyTypes [ “Egress” ]を明示的に指定する必要があります。同様に、エグレスが許可されないことを指定するポリシーを記述する場合は、"Egress"を含むpolicyTypes値を指定する必要があります(このようなポリシーにはEgressセクションが含まれず、それ以外の場合は[ "Ingress" ]にデフォルト設定されるため)。このフィールドは1.8のベータレベルです

Placement

(出現場所:MultiClusterApplicationConfigurationSpec、MultiClusterComponentSpec、MultiClusterConfigMapSpec、MultiClusterSecretSpec、VerrazzanoProjectSpec)

Placementには、リソースが配置される各クラスタの名前が含まれます。

フィールド 説明
clusters
[]Cluster

クラスタのリスト。

ProjectTemplate

(出現場所:VerrazzanoProjectSpec)

ProjectTemplateには、作成するネームスペースのリストと各ネームスペースのオプションのセキュリティ構成が含まれます。

フィールド 説明
namespaces
[]NamespaceTemplate

このプロジェクトに対して作成するアプリケーション・ネームスペースのリスト。
networkPolicies
[]NetworkPolicyTemplate 		(オプション)

プロジェクト内のネームスペースに適用されるネットワーク・ポリシー。
security
SecuritySpec 		(オプション)

プロジェクト・セキュリティ構成。

SecretTemplate

(出現場所:MultiClusterSecretSpec)

SecretTemplateには、Kubernetes Secretのメタデータおよび仕様があります。

フィールド 説明
data
map[string][]byte

types.goで定義されているstruct Secretのdataフィールドに対応します。
metadata
EmbeddedObjectMeta

シークレットを説明するメタデータ。
stringData
map[string]string

types.goで定義されているstruct SecretのstringDataフィールドに対応します。
type
Kubernetes core/v1.SecretType

シークレットのタイプ。

SecuritySpec

(出現場所:ProjectTemplate)

SecuritySpecは、Verrazzanoプロジェクトのセキュリティ構成を定義します。

フィールド 説明
projectAdminSubjects
[]Kubernetes rbac/v1.Subject 		(オプション)

verrazzano-project-adminロールにバインドするサブジェクト。
projectMonitorSubjects
[]Kubernetes rbac/v1.Subject 		(オプション)

verrazzano-project-monitoringロールにバインドするサブジェクト。

StateType (string alias)

(出現場所:ClusterLevelStatus、MultiClusterResourceStatus)

StateTypeは、マルチクラスタ・リソースの状態を識別します。

値 説明

"Failed"

Failedは、指定されたクラスタへのデプロイが失敗したときの状態です。

"Pending"

Pendingは、指定されたクラスタへのデプロイが進行中の状態です。

"Succeeded"

Succeededは、指定されたクラスタへのデプロイが完了したときの状態です。

VerrazzanoProjectSpec

(出現場所:VerrazzanoProject)

VerrazzanoProjectSpecは、Verrazzanoプロジェクトの目的の状態を定義します。

フィールド 説明
placement
Placement

ネームスペースが作成されるクラスタ。
template
ProjectTemplate

プロジェクト・テンプレート。

gitコミット7e2b8b262でgen-crd-api-reference-docsを使用して生成されます。