civo.getKubernetesCluster

Provides a Civo Kubernetes cluster data source.

Note: This data source returns a single Kubernetes cluster. When specifying a name, an error will be raised if more than one Kubernetes cluster found.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Civo = Pulumi.Civo;

return await Deployment.RunAsync(() => 
{
    var my_cluster = Civo.GetKubernetesCluster.Invoke(new()
    {
        Name = "my-super-cluster",
    });

    return new Dictionary<string, object?>
    {
        ["kubernetesClusterOutput"] = my_cluster.Apply(my_cluster => my_cluster.Apply(getKubernetesClusterResult => getKubernetesClusterResult.MasterIp)),
    };
});
package main

import (
	"github.com/pulumi/pulumi-civo/sdk/v2/go/civo"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		my_cluster, err := civo.LookupKubernetesCluster(ctx, &civo.LookupKubernetesClusterArgs{
			Name: pulumi.StringRef("my-super-cluster"),
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("kubernetesClusterOutput", my_cluster.MasterIp)
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.civo.CivoFunctions;
import com.pulumi.civo.inputs.GetKubernetesClusterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var my-cluster = CivoFunctions.getKubernetesCluster(GetKubernetesClusterArgs.builder()
            .name("my-super-cluster")
            .build());

        ctx.export("kubernetesClusterOutput", my_cluster.masterIp());
    }
}
import pulumi
import pulumi_civo as civo

my_cluster = civo.get_kubernetes_cluster(name="my-super-cluster")
pulumi.export("kubernetesClusterOutput", my_cluster.master_ip)
import * as pulumi from "@pulumi/pulumi";
import * as civo from "@pulumi/civo";

const my-cluster = civo.getKubernetesCluster({
    name: "my-super-cluster",
});
export const kubernetesClusterOutput = my_cluster.then(my_cluster => my_cluster.masterIp);
variables:
  my-cluster:
    fn::invoke:
      Function: civo:getKubernetesCluster
      Arguments:
        name: my-super-cluster
outputs:
  kubernetesClusterOutput: ${["my-cluster"].masterIp}

Using getKubernetesCluster

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getKubernetesCluster(args: GetKubernetesClusterArgs, opts?: InvokeOptions): Promise<GetKubernetesClusterResult>
function getKubernetesClusterOutput(args: GetKubernetesClusterOutputArgs, opts?: InvokeOptions): Output<GetKubernetesClusterResult>
def get_kubernetes_cluster(id: Optional[str] = None,
                           name: Optional[str] = None,
                           region: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetKubernetesClusterResult
def get_kubernetes_cluster_output(id: Optional[pulumi.Input[str]] = None,
                           name: Optional[pulumi.Input[str]] = None,
                           region: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetKubernetesClusterResult]
func LookupKubernetesCluster(ctx *Context, args *LookupKubernetesClusterArgs, opts ...InvokeOption) (*LookupKubernetesClusterResult, error)
func LookupKubernetesClusterOutput(ctx *Context, args *LookupKubernetesClusterOutputArgs, opts ...InvokeOption) LookupKubernetesClusterResultOutput

> Note: This function is named LookupKubernetesCluster in the Go SDK.

public static class GetKubernetesCluster 
{
    public static Task<GetKubernetesClusterResult> InvokeAsync(GetKubernetesClusterArgs args, InvokeOptions? opts = null)
    public static Output<GetKubernetesClusterResult> Invoke(GetKubernetesClusterInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetKubernetesClusterResult> getKubernetesCluster(GetKubernetesClusterArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: civo:index/getKubernetesCluster:getKubernetesCluster
  arguments:
    # arguments dictionary

The following arguments are supported:

Id string

The ID of this resource.

Name string

The name of the Kubernetes Cluster

Region string

The region where cluster is running

Id string

The ID of this resource.

Name string

The name of the Kubernetes Cluster

Region string

The region where cluster is running

id String

The ID of this resource.

name String

The name of the Kubernetes Cluster

region String

The region where cluster is running

id string

The ID of this resource.

name string

The name of the Kubernetes Cluster

region string

The region where cluster is running

id str

The ID of this resource.

name str

The name of the Kubernetes Cluster

region str

The region where cluster is running

id String

The ID of this resource.

name String

The name of the Kubernetes Cluster

region String

The region where cluster is running

getKubernetesCluster Result

The following output properties are available:

ApiEndpoint string

The base URL of the API server on the Kubernetes master node

Applications string

A list of application installed

Cni string

The cni for the k3s to install (the default is flannel) valid options are cilium or flannel

CreatedAt string

The date where the Kubernetes cluster was create

DnsEntry string

The unique dns entry for the cluster in this case point to the master

InstalledApplications List<GetKubernetesClusterInstalledApplication>
Kubeconfig string

A representation of the Kubernetes cluster's kubeconfig in yaml format

KubernetesVersion string

The version of Kubernetes

MasterIp string

The IP of the Kubernetes master node

NumTargetNodes int

The size of the Kubernetes cluster

Deprecated:

This field is deprecated and will be removed in a future version of the provider

Pools List<GetKubernetesClusterPool>
Ready bool

If the Kubernetes cluster is ready

Status string

The status of Kubernetes cluster

Tags List<string>

A list of tags

TargetNodesSize string

The size of each node

Deprecated:

This field is deprecated and will be removed in a future version of the provider

Id string

The ID of this resource.

Name string

The name of the Kubernetes Cluster

Region string

The region where cluster is running

ApiEndpoint string

The base URL of the API server on the Kubernetes master node

Applications string

A list of application installed

Cni string

The cni for the k3s to install (the default is flannel) valid options are cilium or flannel

CreatedAt string

The date where the Kubernetes cluster was create

DnsEntry string

The unique dns entry for the cluster in this case point to the master

InstalledApplications []GetKubernetesClusterInstalledApplication
Kubeconfig string

A representation of the Kubernetes cluster's kubeconfig in yaml format

KubernetesVersion string

The version of Kubernetes

MasterIp string

The IP of the Kubernetes master node

NumTargetNodes int

The size of the Kubernetes cluster

Deprecated:

This field is deprecated and will be removed in a future version of the provider

Pools []GetKubernetesClusterPool
Ready bool

If the Kubernetes cluster is ready

Status string

The status of Kubernetes cluster

Tags []string

A list of tags

TargetNodesSize string

The size of each node

Deprecated:

This field is deprecated and will be removed in a future version of the provider

Id string

The ID of this resource.

Name string

The name of the Kubernetes Cluster

Region string

The region where cluster is running

apiEndpoint String

The base URL of the API server on the Kubernetes master node

applications String

A list of application installed

cni String

The cni for the k3s to install (the default is flannel) valid options are cilium or flannel

createdAt String

The date where the Kubernetes cluster was create

dnsEntry String

The unique dns entry for the cluster in this case point to the master

installedApplications List<GetKubernetesClusterInstalledApplication>
kubeconfig String

A representation of the Kubernetes cluster's kubeconfig in yaml format

kubernetesVersion String

The version of Kubernetes

masterIp String

The IP of the Kubernetes master node

numTargetNodes Integer

The size of the Kubernetes cluster

Deprecated:

This field is deprecated and will be removed in a future version of the provider

pools List<GetKubernetesClusterPool>
ready Boolean

If the Kubernetes cluster is ready

status String

The status of Kubernetes cluster

tags List<String>

A list of tags

targetNodesSize String

The size of each node

Deprecated:

This field is deprecated and will be removed in a future version of the provider

id String

The ID of this resource.

name String

The name of the Kubernetes Cluster

region String

The region where cluster is running

apiEndpoint string

The base URL of the API server on the Kubernetes master node

applications string

A list of application installed

cni string

The cni for the k3s to install (the default is flannel) valid options are cilium or flannel

createdAt string

The date where the Kubernetes cluster was create

dnsEntry string

The unique dns entry for the cluster in this case point to the master

installedApplications GetKubernetesClusterInstalledApplication[]
kubeconfig string

A representation of the Kubernetes cluster's kubeconfig in yaml format

kubernetesVersion string

The version of Kubernetes

masterIp string

The IP of the Kubernetes master node

numTargetNodes number

The size of the Kubernetes cluster

Deprecated:

This field is deprecated and will be removed in a future version of the provider

pools GetKubernetesClusterPool[]
ready boolean

If the Kubernetes cluster is ready

status string

The status of Kubernetes cluster

tags string[]

A list of tags

targetNodesSize string

The size of each node

Deprecated:

This field is deprecated and will be removed in a future version of the provider

id string

The ID of this resource.

name string

The name of the Kubernetes Cluster

region string

The region where cluster is running

api_endpoint str

The base URL of the API server on the Kubernetes master node

applications str

A list of application installed

cni str

The cni for the k3s to install (the default is flannel) valid options are cilium or flannel

created_at str

The date where the Kubernetes cluster was create

dns_entry str

The unique dns entry for the cluster in this case point to the master

installed_applications Sequence[GetKubernetesClusterInstalledApplication]
kubeconfig str

A representation of the Kubernetes cluster's kubeconfig in yaml format

kubernetes_version str

The version of Kubernetes

master_ip str

The IP of the Kubernetes master node

num_target_nodes int

The size of the Kubernetes cluster

Deprecated:

This field is deprecated and will be removed in a future version of the provider

pools Sequence[GetKubernetesClusterPool]
ready bool

If the Kubernetes cluster is ready

status str

The status of Kubernetes cluster

tags Sequence[str]

A list of tags

target_nodes_size str

The size of each node

Deprecated:

This field is deprecated and will be removed in a future version of the provider

id str

The ID of this resource.

name str

The name of the Kubernetes Cluster

region str

The region where cluster is running

apiEndpoint String

The base URL of the API server on the Kubernetes master node

applications String

A list of application installed

cni String

The cni for the k3s to install (the default is flannel) valid options are cilium or flannel

createdAt String

The date where the Kubernetes cluster was create

dnsEntry String

The unique dns entry for the cluster in this case point to the master

installedApplications List<Property Map>
kubeconfig String

A representation of the Kubernetes cluster's kubeconfig in yaml format

kubernetesVersion String

The version of Kubernetes

masterIp String

The IP of the Kubernetes master node

numTargetNodes Number

The size of the Kubernetes cluster

Deprecated:

This field is deprecated and will be removed in a future version of the provider

pools List<Property Map>
ready Boolean

If the Kubernetes cluster is ready

status String

The status of Kubernetes cluster

tags List<String>

A list of tags

targetNodesSize String

The size of each node

Deprecated:

This field is deprecated and will be removed in a future version of the provider

id String

The ID of this resource.

name String

The name of the Kubernetes Cluster

region String

The region where cluster is running

Supporting Types

GetKubernetesClusterInstalledApplication

Application string
Category string
Installed bool
Version string
Application string
Category string
Installed bool
Version string
application String
category String
installed Boolean
version String
application string
category string
installed boolean
version string
application String
category String
installed Boolean
version String

GetKubernetesClusterPool

InstanceNames List<string>
Label string
NodeCount int
Size string
InstanceNames []string
Label string
NodeCount int
Size string
instanceNames List<String>
label String
nodeCount Integer
size String
instanceNames string[]
label string
nodeCount number
size string
instance_names Sequence[str]
label str
node_count int
size str
instanceNames List<String>
label String
nodeCount Number
size String

Package Details

Repository
Civo pulumi/pulumi-civo
License
Apache-2.0
Notes

This Pulumi package is based on the civo Terraform Provider.