UNPKG

@pulumiverse/scaleway

Version:

A Pulumi package for creating and managing Scaleway cloud resources.

367 lines 14.9 kB
"use strict"; // *** WARNING: this file was generated by pulumi-language-nodejs. *** // *** Do not edit by hand unless you're certain you know what you are doing! *** var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) { if (k2 === undefined) k2 = k; var desc = Object.getOwnPropertyDescriptor(m, k); if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) { desc = { enumerable: true, get: function() { return m[k]; } }; } Object.defineProperty(o, k2, desc); }) : (function(o, m, k, k2) { if (k2 === undefined) k2 = k; o[k2] = m[k]; })); var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) { Object.defineProperty(o, "default", { enumerable: true, value: v }); }) : function(o, v) { o["default"] = v; }); var __importStar = (this && this.__importStar) || function (mod) { if (mod && mod.__esModule) return mod; var result = {}; if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k); __setModuleDefault(result, mod); return result; }; Object.defineProperty(exports, "__esModule", { value: true }); exports.Cluster = void 0; const pulumi = __importStar(require("@pulumi/pulumi")); const utilities = __importStar(require("../utilities")); /** * The `scaleway.kubernetes.Cluster` resource allows you to create and manage Scaleway Kubernetes clusters. * * Refer to the Kubernetes [documentation](https://www.scaleway.com/en/docs/compute/kubernetes/) and [API documentation](https://www.scaleway.com/en/developers/api/kubernetes/) for more information. * * ## Example Usage * * ### Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as scaleway from "@pulumiverse/scaleway"; * * const pn = new scaleway.network.PrivateNetwork("pn", {}); * const cluster = new scaleway.kubernetes.Cluster("cluster", { * name: "tf-cluster", * version: "1.35.3", * cni: "cilium", * privateNetworkId: pn.id, * deleteAdditionalResources: false, * }); * const pool = new scaleway.kubernetes.Pool("pool", { * clusterId: cluster.id, * version: cluster.version, * name: "tf-pool", * nodeType: "DEV1-M", * size: 1, * }); * ``` * * ### Using autoscalerConfig * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as scaleway from "@pulumiverse/scaleway"; * * const pn = new scaleway.network.PrivateNetwork("pn", {}); * const cluster = new scaleway.kubernetes.Cluster("cluster", { * name: "tf-cluster", * description: "cluster made in terraform", * version: "1.35.3", * cni: "calico", * tags: ["terraform"], * privateNetworkId: pn.id, * deleteAdditionalResources: false, * autoscalerConfig: { * disableScaleDown: false, * scaleDownDelayAfterAdd: "5m", * estimator: "binpacking", * expander: "random", * ignoreDaemonsetsUtilization: true, * balanceSimilarNodeGroups: true, * expendablePodsPriorityCutoff: -5, * }, * }); * const pool = new scaleway.kubernetes.Pool("pool", { * clusterId: cluster.id, * version: cluster.version, * name: "tf-pool", * nodeType: "DEV1-M", * size: 3, * autoscaling: true, * autohealing: true, * minSize: 1, * maxSize: 5, * }); * ``` * * ### With the Helm provider * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as _null from "@pulumi/null"; * import * as kubernetes from "@pulumi/kubernetes"; * import * as scaleway from "@pulumiverse/scaleway"; * * const pn = new scaleway.network.PrivateNetwork("pn", {}); * const cluster = new scaleway.kubernetes.Cluster("cluster", { * name: "tf-cluster", * version: "1.35.3", * cni: "cilium", * deleteAdditionalResources: false, * privateNetworkId: pn.id, * }); * const pool = new scaleway.kubernetes.Pool("pool", { * clusterId: cluster.id, * version: cluster.version, * name: "tf-pool", * nodeType: "DEV1-M", * size: 1, * }); * const kubeconfig = new _null.Resource("kubeconfig", {triggers: { * host: cluster.kubeconfigs.apply(kubeconfigs => kubeconfigs[0].host), * token: cluster.kubeconfigs.apply(kubeconfigs => kubeconfigs[0].token), * clusterCaCertificate: cluster.kubeconfigs.apply(kubeconfigs => kubeconfigs[0].clusterCaCertificate), * }}, { * dependsOn: [pool], * }); * const nginxIp = new scaleway.loadbalancers.Ip("nginx_ip", { * zone: "fr-par-1", * projectId: cluster.projectId, * }); * const nginxIngress = new kubernetes.helm.sh/v3.Release("nginx_ingress", { * name: "nginx-ingress", * namespace: "kube-system", * repositoryOpts: { * repo: "https://kubernetes.github.io/ingress-nginx", * }, * chart: "ingress-nginx", * values: { * "controller.service.loadBalancerIP": nginxIp.ipAddress, * "controller.config.use-proxy-protocol": "true", * "controller.service.annotations.service\\.beta\\.kubernetes\\.io/scw-loadbalancer-proxy-protocol-v2": "true", * "controller.service.annotations.service\\.beta\\.kubernetes\\.io/scw-loadbalancer-zone": nginxIp.zone, * "controller.service.externalTrafficPolicy": "Local", * }, * }); * ``` * * ### With the Kubernetes provider * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as _null from "@pulumi/null"; * import * as scaleway from "@pulumiverse/scaleway"; * * const pn = new scaleway.network.PrivateNetwork("pn", {}); * const cluster = new scaleway.kubernetes.Cluster("cluster", { * name: "tf-cluster", * version: "1.35.3", * cni: "cilium", * privateNetworkId: pn.id, * deleteAdditionalResources: false, * }); * const pool = new scaleway.kubernetes.Pool("pool", { * clusterId: cluster.id, * version: cluster.version, * name: "tf-pool", * nodeType: "DEV1-M", * size: 1, * }); * // The `null_resource` is needed because when the cluster is created, its status is `pool_required`, but the kubeconfig can already be downloaded. * // It leads the `kubernetes` provider to start creating its objects, but the DNS entry for the Kubernetes master is not yet ready, that's why it's needed to wait for at least a pool. * const kubeconfig = new _null.Resource("kubeconfig", {triggers: { * host: cluster.kubeconfigs.apply(kubeconfigs => kubeconfigs[0].host), * token: cluster.kubeconfigs.apply(kubeconfigs => kubeconfigs[0].token), * clusterCaCertificate: cluster.kubeconfigs.apply(kubeconfigs => kubeconfigs[0].clusterCaCertificate), * }}, { * dependsOn: [pool], * }); * ``` * * ### Multicloud * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as scaleway from "@pulumiverse/scaleway"; * * // For a detailed example of how to add or run Elastic Metal servers instead of Instances on your cluster, please refer to [this guide](../guides/multicloud_cluster_with_baremetal_servers.md). * const cluster = new scaleway.kubernetes.Cluster("cluster", { * name: "tf-cluster", * type: "multicloud", * version: "1.35.3", * cni: "kilo", * deleteAdditionalResources: false, * }); * const pool = new scaleway.kubernetes.Pool("pool", { * clusterId: cluster.id, * version: cluster.version, * name: "tf-pool", * nodeType: "external", * size: 0, * minSize: 0, * }); * ``` * * ## Deprecation of defaultPool * * `defaultPool` is deprecated in favour the `scaleway.kubernetes.Pool` resource. Here is a migration example. * * Before: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as scaleway from "@pulumiverse/scaleway"; * * const cluster = new scaleway.kubernetes.Cluster("cluster", { * name: "tf-cluster", * version: "1.18.0", * cni: "cilium", * defaultPool: [{ * nodeType: "DEV1-M", * size: 1, * }], * }); * ``` * * After: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as scaleway from "@pulumiverse/scaleway"; * * const cluster = new scaleway.kubernetes.Cluster("cluster", { * name: "tf-cluster", * version: "1.18.0", * cni: "cilium", * }); * const _default = new scaleway.kubernetes.Pool("default", { * clusterId: jack.id, * name: "default", * nodeType: "DEV1-M", * size: 1, * }); * ``` * * Once you have moved all the `defaultPool` into their own object, you will need to import them. If your pool had the ID 11111111-1111-1111-1111-111111111111 in the `fr-par` region, you can import it by typing: * * Then you will only need to type `pulumi up` to have a smooth migration. * * ## Import * * Kubernetes clusters can be imported using the `{region}/{id}`, e.g. * * ```sh * $ pulumi import scaleway:kubernetes/cluster:Cluster mycluster fr-par/11111111-1111-1111-1111-111111111111 * ``` */ class Cluster extends pulumi.CustomResource { /** * Get an existing Cluster resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name, id, state, opts) { return new Cluster(name, state, { ...opts, id: id }); } /** @internal */ static __pulumiType = 'scaleway:kubernetes/cluster:Cluster'; /** * Returns true if the given object is an instance of Cluster. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj) { if (obj === undefined || obj === null) { return false; } return obj['__pulumiType'] === Cluster.__pulumiType; } constructor(name, argsOrState, opts) { let resourceInputs = {}; opts = opts || {}; if (opts.id) { const state = argsOrState; resourceInputs["admissionPlugins"] = state?.admissionPlugins; resourceInputs["apiserverCertSans"] = state?.apiserverCertSans; resourceInputs["apiserverUrl"] = state?.apiserverUrl; resourceInputs["autoUpgrade"] = state?.autoUpgrade; resourceInputs["autoscalerConfig"] = state?.autoscalerConfig; resourceInputs["cni"] = state?.cni; resourceInputs["createdAt"] = state?.createdAt; resourceInputs["deleteAdditionalResources"] = state?.deleteAdditionalResources; resourceInputs["description"] = state?.description; resourceInputs["featureGates"] = state?.featureGates; resourceInputs["kubeconfigs"] = state?.kubeconfigs; resourceInputs["name"] = state?.name; resourceInputs["openIdConnectConfig"] = state?.openIdConnectConfig; resourceInputs["organizationId"] = state?.organizationId; resourceInputs["podCidr"] = state?.podCidr; resourceInputs["privateNetworkId"] = state?.privateNetworkId; resourceInputs["projectId"] = state?.projectId; resourceInputs["region"] = state?.region; resourceInputs["serviceCidr"] = state?.serviceCidr; resourceInputs["serviceDnsIp"] = state?.serviceDnsIp; resourceInputs["status"] = state?.status; resourceInputs["tags"] = state?.tags; resourceInputs["type"] = state?.type; resourceInputs["updatedAt"] = state?.updatedAt; resourceInputs["upgradeAvailable"] = state?.upgradeAvailable; resourceInputs["upgradePools"] = state?.upgradePools; resourceInputs["version"] = state?.version; resourceInputs["wildcardDns"] = state?.wildcardDns; } else { const args = argsOrState; if (args?.cni === undefined && !opts.urn) { throw new Error("Missing required property 'cni'"); } if (args?.deleteAdditionalResources === undefined && !opts.urn) { throw new Error("Missing required property 'deleteAdditionalResources'"); } if (args?.version === undefined && !opts.urn) { throw new Error("Missing required property 'version'"); } resourceInputs["admissionPlugins"] = args?.admissionPlugins; resourceInputs["apiserverCertSans"] = args?.apiserverCertSans; resourceInputs["autoUpgrade"] = args?.autoUpgrade; resourceInputs["autoscalerConfig"] = args?.autoscalerConfig; resourceInputs["cni"] = args?.cni; resourceInputs["deleteAdditionalResources"] = args?.deleteAdditionalResources; resourceInputs["description"] = args?.description; resourceInputs["featureGates"] = args?.featureGates; resourceInputs["name"] = args?.name; resourceInputs["openIdConnectConfig"] = args?.openIdConnectConfig; resourceInputs["podCidr"] = args?.podCidr; resourceInputs["privateNetworkId"] = args?.privateNetworkId; resourceInputs["projectId"] = args?.projectId; resourceInputs["region"] = args?.region; resourceInputs["serviceCidr"] = args?.serviceCidr; resourceInputs["serviceDnsIp"] = args?.serviceDnsIp; resourceInputs["tags"] = args?.tags; resourceInputs["type"] = args?.type; resourceInputs["upgradePools"] = args?.upgradePools; resourceInputs["version"] = args?.version; resourceInputs["apiserverUrl"] = undefined /*out*/; resourceInputs["createdAt"] = undefined /*out*/; resourceInputs["kubeconfigs"] = undefined /*out*/; resourceInputs["organizationId"] = undefined /*out*/; resourceInputs["status"] = undefined /*out*/; resourceInputs["updatedAt"] = undefined /*out*/; resourceInputs["upgradeAvailable"] = undefined /*out*/; resourceInputs["wildcardDns"] = undefined /*out*/; } opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts); const aliasOpts = { aliases: [{ type: "scaleway:index/kubernetesCluster:KubernetesCluster" }] }; opts = pulumi.mergeOptions(opts, aliasOpts); const secretOpts = { additionalSecretOutputs: ["kubeconfigs"] }; opts = pulumi.mergeOptions(opts, secretOpts); super(Cluster.__pulumiType, name, resourceInputs, opts); } } exports.Cluster = Cluster; //# sourceMappingURL=cluster.js.map