Skip to main content

@swamp/gcp/gkeonprem

v2026.04.23.1

Google Cloud gkeonprem infrastructure models

Repository

https://github.com/systeminit/swamp-extensions

Labels

gcpgoogle-cloudgkeonpremcloudinfrastructure

Contents

Quality score

Verified by Swamp

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @swamp/gcp/gkeonprem

@swamp/gcp/gkeonprem/baremetaladminclustersv2026.04.23.1baremetaladminclusters.ts

Global Arguments

ArgumentTypeDescription
annotations?recordAnnotations on the bare metal admin cluster. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.
bareMetalVersion?stringThe Anthos clusters on bare metal version for the bare metal admin cluster.
binaryAuthorization?objectConfiguration for Binary Authorization.
clusterOperations?objectBareMetalAdminClusterOperationsConfig specifies the admin cluster's observability infrastructure.
controlPlane?objectBareMetalAdminControlPlaneConfig specifies the control plane configuration.
description?stringA human readable description of this bare metal admin cluster.
fleet?objectFleet related configuration. Fleets are a Google Cloud concept for logically organizing clusters, letting you use and manage multi-cluster capabilities and apply consistent policies across your systems. See [Anthos Fleets](`https://cloud.google.com/anthos/multicluster-management/fleets`) for more details on Anthos multi-cluster capabilities using Fleets. ##
loadBalancer?objectBareMetalAdminLoadBalancerConfig specifies the load balancer configuration.
maintenanceConfig?objectBareMetalAdminMaintenanceConfig specifies configurations to put bare metal Admin cluster CRs nodes in and out of maintenance.
maintenanceStatus?objectBareMetalAdminMaintenanceStatus represents the maintenance status for bare metal Admin cluster CR's nodes.
name?stringImmutable. The bare metal admin cluster resource name.
networkConfig?objectBareMetalAdminNetworkConfig specifies the cluster network configuration.
nodeAccessConfig?objectSpecifies the node access related settings for the bare metal admin cluster.
nodeConfig?objectBareMetalAdminWorkloadNodeConfig specifies the workload node configurations.
osEnvironmentConfig?objectSpecifies operating system operation settings for cluster provisioning.
proxy?objectBareMetalAdminProxyConfig specifies the cluster proxy configuration.
securityConfig?objectSpecifies the security related settings for the bare metal admin cluster.
status?objectResourceStatus describes why a cluster or node pool has a certain status. (e.g., ERROR or DEGRADED).
storage?objectBareMetalAdminStorageConfig specifies the cluster storage configuration.
validationCheck?objectValidationCheck represents the result of preflight check.
allowPreflightFailure?stringOptional. If set to true, CLM will force CCFE to persist the cluster resource in RMS when the creation fails during standalone preflight checks. In that case the subsequent create call will fail with "cluster already exists" error and hence a update cluster is required to fix the cluster.
bareMetalAdminClusterId?stringRequired. User provided identifier that is used as part of the resource name; must conform to RFC-1034 and additionally restrict to lower-cased letters. This comes out roughly to: /^a-z+[a-z0-9]$/
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
createCreate a bareMetalAdminClusters
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after creation (default: true)
getGet a bareMetalAdminClusters
ArgumentTypeDescription
identifierstringThe name of the bareMetalAdminClusters
updateUpdate bareMetalAdminClusters attributes
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after update (default: true)
syncSync bareMetalAdminClusters state from GCP
enrollenroll
ArgumentTypeDescription
bareMetalAdminClusterId?any
membership?any
query_version_configquery version config
unenrollunenroll

Resources

state(infinite)— Resource that represents a bare metal admin cluster.
@swamp/gcp/gkeonprem/baremetalclustersv2026.04.23.1baremetalclusters.ts

Global Arguments

ArgumentTypeDescription
adminClusterMembership?stringRequired. The admin cluster this bare metal user cluster belongs to. This is the full resource name of the admin cluster's fleet membership.
annotations?recordAnnotations on the bare metal user cluster. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.
bareMetalVersion?stringRequired. The Anthos clusters on bare metal version for your user cluster.
binaryAuthorization?objectConfiguration for Binary Authorization.
clusterOperations?objectSpecifies the bare metal user cluster's observability infrastructure.
controlPlane?objectSpecifies the control plane configuration.
description?stringA human readable description of this bare metal user cluster.
fleet?objectFleet related configuration. Fleets are a Google Cloud concept for logically organizing clusters, letting you use and manage multi-cluster capabilities and apply consistent policies across your systems. See [Anthos Fleets](`https://cloud.google.com/anthos/multicluster-management/fleets`) for more details on Anthos multi-cluster capabilities using Fleets. ##
loadBalancer?objectSpecifies the load balancer configuration.
maintenanceConfig?objectSpecifies configurations to put bare metal nodes in and out of maintenance.
maintenanceStatus?objectRepresents the maintenance status of the bare metal user cluster.
name?stringImmutable. The bare metal user cluster resource name.
networkConfig?objectSpecifies the cluster network configuration.
nodeAccessConfig?objectSpecifies the node access related settings for the bare metal user cluster.
nodeConfig?objectSpecifies the workload node configurations.
osEnvironmentConfig?objectSpecifies operating system settings for cluster provisioning.
proxy?objectSpecifies the cluster proxy configuration.
securityConfig?objectSpecifies the security related settings for the bare metal user cluster.
status?objectResourceStatus describes why a cluster or node pool has a certain status. (e.g., ERROR or DEGRADED).
storage?objectBareMetalStorageConfig specifies the cluster storage configuration.
upgradePolicy?objectBareMetalClusterUpgradePolicy defines the cluster upgrade policy.
validationCheck?objectValidationCheck represents the result of preflight check.
allowPreflightFailure?stringOptional. If set to true, CLM will force CCFE to persist the cluster resource in RMS when the creation fails during standalone preflight checks. In that case the subsequent create call will fail with "cluster already exists" error and hence a update cluster is required to fix the cluster.
bareMetalClusterId?stringRequired. User provided identifier that is used as part of the resource name; must conform to RFC-1034 and additionally restrict to lower-cased letters. This comes out roughly to: /^a-z+[a-z0-9]$/
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
createCreate a bareMetalClusters
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after creation (default: true)
getGet a bareMetalClusters
ArgumentTypeDescription
identifierstringThe name of the bareMetalClusters
updateUpdate bareMetalClusters attributes
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after update (default: true)
deleteDelete the bareMetalClusters
ArgumentTypeDescription
identifierstringThe name of the bareMetalClusters
syncSync bareMetalClusters state from GCP
enrollenroll
ArgumentTypeDescription
adminClusterMembership?any
bareMetalClusterId?any
localName?any
localNamespace?any
query_version_configquery version config
unenrollunenroll

Resources

state(infinite)— Resource that represents a bare metal user cluster.
@swamp/gcp/gkeonprem/baremetalclusters-baremetalnodepoolsv2026.04.23.1baremetalclusters_baremetalnodepools.ts

Global Arguments

ArgumentTypeDescription
annotations?recordAnnotations on the bare metal node pool. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.
displayName?stringThe display name for the bare metal node pool.
name?stringImmutable. The bare metal node pool resource name.
nodePoolConfig?objectBareMetalNodePoolConfig describes the configuration of all nodes within a given bare metal node pool.
status?objectResourceStatus describes why a cluster or node pool has a certain status. (e.g., ERROR or DEGRADED).
upgradePolicy?objectBareMetalNodePoolUpgradePolicy defines the node pool upgrade policy.
bareMetalNodePoolId?stringThe ID to use for the node pool, which will become the final component of the node pool's resource name. This value must be up to 63 characters, and valid characters are /a-z-/. The value must not be permitted to be a UUID (or UUID-like: anything matching /^[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i).
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
createCreate a bareMetalNodePools
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after creation (default: true)
getGet a bareMetalNodePools
ArgumentTypeDescription
identifierstringThe name of the bareMetalNodePools
updateUpdate bareMetalNodePools attributes
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after update (default: true)
deleteDelete the bareMetalNodePools
ArgumentTypeDescription
identifierstringThe name of the bareMetalNodePools
syncSync bareMetalNodePools state from GCP
enrollenroll
ArgumentTypeDescription
bareMetalNodePoolId?any
validateOnly?any
unenrollunenroll

Resources

state(infinite)— Resource that represents a bare metal node pool.
@swamp/gcp/gkeonprem/locationsv2026.04.23.1locations.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
getGet a locations
ArgumentTypeDescription
identifierstringThe name of the locations
syncSync locations state from GCP

Resources

state(infinite)— A resource that represents a Google Cloud location.
@swamp/gcp/gkeonprem/vmwareadminclustersv2026.04.23.1vmwareadminclusters.ts

Global Arguments

ArgumentTypeDescription
addonNode?objectVmwareAdminAddonNodeConfig contains add-on node configurations for VMware admin cluster.
annotations?recordAnnotations on the VMware admin cluster. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.
antiAffinityGroups?objectSpecifies anti affinity group config for the VMware user cluster.
authorization?objectVmwareAdminAuthorizationConfig represents configuration for admin cluster authorization.
autoRepairConfig?objectSpecifies config to enable/disable auto repair. The cluster-health-controller is deployed only if Enabled is true.
bootstrapClusterMembership?stringThe bootstrap cluster this VMware admin cluster belongs to.
controlPlaneNode?objectVmwareAdminControlPlaneNodeConfig contains control plane node configuration for VMware admin cluster.
description?stringA human readable description of this VMware admin cluster.
enableAdvancedCluster?booleanEnable advanced cluster.
fleet?objectFleet related configuration. Fleets are a Google Cloud concept for logically organizing clusters, letting you use and manage multi-cluster capabilities and apply consistent policies across your systems. See [Anthos Fleets](`https://cloud.google.com/anthos/multicluster-management/fleets`) for more details on Anthos multi-cluster capabilities using Fleets. ##
imageType?stringThe OS image type for the VMware admin cluster.
loadBalancer?objectVmwareAdminLoadBalancerConfig contains load balancer configuration for VMware admin cluster.
name?stringImmutable. The VMware admin cluster resource name.
networkConfig?objectVmwareAdminNetworkConfig contains network configuration for VMware admin cluster.
onPremVersion?stringThe Anthos clusters on the VMware version for the admin cluster.
platformConfig?objectVmwarePlatformConfig represents configuration for the VMware platform.
preparedSecrets?objectVmwareAdminPreparedSecretsConfig represents configuration for admin cluster prepared secrets.
privateRegistryConfig?objectVmwareAdminPrivateRegistryConfig represents configuration for admin cluster registry.
proxy?objectVmwareAdminProxy represents configuration for admin cluster proxy.
status?objectResourceStatus describes why a cluster or node pool has a certain status. (e.g., ERROR or DEGRADED).
validationCheck?objectValidationCheck represents the result of preflight check.
vcenter?objectVmwareAdminVCenterConfig contains VCenter configuration for VMware admin cluster.
allowPreflightFailure?stringOptional. If set to true, CLM will force CCFE to persist the cluster resource in RMS when the creation fails during standalone preflight checks. In that case the subsequent create call will fail with "cluster already exists" error and hence a update cluster is required to fix the cluster.
skipValidations?stringOptional. If set, skip the specified validations.
vmwareAdminClusterId?stringRequired. User provided identifier that is used as part of the resource name; must conform to RFC-1034 and additionally restrict to lower-cased letters. This comes out roughly to: /^a-z+[a-z0-9]$/
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
createCreate a vmwareAdminClusters
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after creation (default: true)
getGet a vmwareAdminClusters
ArgumentTypeDescription
identifierstringThe name of the vmwareAdminClusters
updateUpdate vmwareAdminClusters attributes
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after update (default: true)
syncSync vmwareAdminClusters state from GCP
enrollenroll
ArgumentTypeDescription
membership?any
vmwareAdminClusterId?any
unenrollunenroll

Resources

state(infinite)— Resource that represents a VMware admin cluster.
@swamp/gcp/gkeonprem/vmwareclustersv2026.04.23.1vmwareclusters.ts

Global Arguments

ArgumentTypeDescription
adminClusterMembership?stringRequired. The admin cluster this VMware user cluster belongs to. This is the full resource name of the admin cluster's fleet membership. In the future, references to other resource types might be allowed if admin clusters are modeled as their own resources.
annotations?recordAnnotations on the VMware user cluster. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.
antiAffinityGroups?objectSpecifies anti affinity group config for the VMware user cluster.
authorization?objectAuthorization defines the On-Prem cluster authorization configuration to bootstrap onto the admin cluster.
autoRepairConfig?objectSpecifies config to enable/disable auto repair. The cluster-health-controller is deployed only if Enabled is true.
binaryAuthorization?objectConfiguration for Binary Authorization.
controlPlaneNode?objectSpecifies control plane node config for the VMware user cluster.
dataplaneV2?objectContains configurations for Dataplane V2, which is optimized dataplane for Kubernetes networking. For more information, see: https://cloud.google.com/kubernetes-engine/docs/concepts/dataplane-v2
description?stringA human readable description of this VMware user cluster.
disableBundledIngress?booleanDisable bundled ingress.
enableAdvancedCluster?booleanEnable advanced cluster.
enableControlPlaneV2?booleanEnable control plane V2. Default to false.
fleet?objectFleet related configuration. Fleets are a Google Cloud concept for logically organizing clusters, letting you use and manage multi-cluster capabilities and apply consistent policies across your systems. See [Anthos Fleets](`https://cloud.google.com/anthos/multicluster-management/fleets`) for more details on Anthos multi-cluster capabilities using Fleets. ##
loadBalancer?objectSpecifies the locad balancer config for the VMware user cluster.
name?stringImmutable. The VMware user cluster resource name.
networkConfig?objectSpecifies network config for the VMware user cluster.
onPremVersion?stringRequired. The Anthos clusters on the VMware version for your user cluster.
status?objectResourceStatus describes why a cluster or node pool has a certain status. (e.g., ERROR or DEGRADED).
storage?objectSpecifies vSphere CSI components deployment config in the VMware user cluster.
upgradePolicy?objectVmwareClusterUpgradePolicy defines the cluster upgrade policy.
validationCheck?objectValidationCheck represents the result of preflight check.
vcenter?objectRepresents configuration for the VMware VCenter for the user cluster.
vmTrackingEnabled?booleanEnable VM tracking.
allowPreflightFailure?stringOptional. If set to true, CLM will force CCFE to persist the cluster resource in RMS when the creation fails during standalone preflight checks. In that case the subsequent create call will fail with "cluster already exists" error and hence a update cluster is required to fix the cluster.
skipValidations?stringOptional. List of validations to skip during cluster creation.
vmwareClusterId?stringUser provided identifier that is used as part of the resource name; This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format.
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
createCreate a vmwareClusters
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after creation (default: true)
getGet a vmwareClusters
ArgumentTypeDescription
identifierstringThe name of the vmwareClusters
updateUpdate vmwareClusters attributes
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after update (default: true)
deleteDelete the vmwareClusters
ArgumentTypeDescription
identifierstringThe name of the vmwareClusters
syncSync vmwareClusters state from GCP
enrollenroll
ArgumentTypeDescription
adminClusterMembership?any
localName?any
validateOnly?any
vmwareClusterId?any
query_version_configquery version config
unenrollunenroll

Resources

state(infinite)— Resource that represents a VMware user cluster. ##
@swamp/gcp/gkeonprem/vmwareclusters-vmwarenodepoolsv2026.04.23.1vmwareclusters_vmwarenodepools.ts

Global Arguments

ArgumentTypeDescription
annotations?recordAnnotations on the node pool. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.
config?objectParameters that describe the configuration of all nodes within a given node pool.
displayName?stringThe display name for the node pool.
name?stringImmutable. The resource name of this node pool.
nodePoolAutoscaling?objectNodePoolAutoscaling config for the NodePool to allow for the kubernetes to scale NodePool.
onPremVersion?stringAnthos version for the node pool. Defaults to the user cluster version.
status?objectResourceStatus describes why a cluster or node pool has a certain status. (e.g., ERROR or DEGRADED).
vmwareNodePoolId?stringThe ID to use for the node pool, which will become the final component of the node pool's resource name. This value must be up to 40 characters and follow RFC-1123 (https://tools.ietf.org/html/rfc1123) format. The value must not be permitted to be a UUID (or UUID-like: anything matching /^[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i).
location?stringThe location for this resource (e.g., 'us', 'us-central1', 'europe-west1')
createCreate a vmwareNodePools
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after creation (default: true)
getGet a vmwareNodePools
ArgumentTypeDescription
identifierstringThe name of the vmwareNodePools
updateUpdate vmwareNodePools attributes
ArgumentTypeDescription
waitForReady?booleanWait for the resource to reach a ready state after update (default: true)
deleteDelete the vmwareNodePools
ArgumentTypeDescription
identifierstringThe name of the vmwareNodePools
syncSync vmwareNodePools state from GCP
enrollenroll
ArgumentTypeDescription
vmwareNodePoolId?any
unenrollunenroll

Resources

state(infinite)— Resource VmwareNodePool represents a VMware node pool. ##