exo(1)

📦
version 1.102.1 · 2 versions
, in nixpkgs unstable

✨ exo(1) ✨

So this is the manual page for the exo CLI's SKS cluster creation command, bestie—it's the one that spins up Kubernetes clusters on Exoscale and it's genuinely iconic. It lives at exo(1) and slay, because this thing does a LOT. Let's get into it 💅

🎀 NAME 🎀

exo-compute-sks-create — Create an SKS cluster, periodt.

🌸 SYNOPSIS 🌸

exo compute sks create NAME [flags]

🦋 DESCRIPTION 🦋

Okay so bestie, this command literally creates an SKS cluster. Main character energy only. 🔥

Lowkey important vibe check though: by default, SKS cluster Nodes' kubelet configuration is set to use the Exoscale Cloud Controller Manager (CCM) as Cloud Provider. That means cluster Nodes will stay in the "NotReady" status until the Exoscale CCM is deployed by cluster operators. No cap, this is just how it is. For more info, go check the Exoscale CCM documentation:

https://github.com/exoscale/exoscale-cloud-controller-manager

If you don't want to use a Cloud Controller Manager, just add the --no-exoscale-ccm option to the command. But heads up: this cannot be changed once the cluster has been created. So fr fr, think about it first. 😭

Supported output template annotations, and yes you need all of them, no skipping: .ID, .Name, .Description, .CreationDate, .AutoUpgrade, .EnableKubeProxy, .Zone, .Endpoint, .Version, .ServiceLevel, .CNI, .AddOns, .AuditEnabled, .AuditEndpoint, .AuditInitialBackoff, .FeatureGates, .State, .Labels, .Nodepools, .KarpenterFeatureGates.

✨ OPTIONS ✨

Okay we're about to go through every single flag, bestie, so buckle up. Iconic behavior. 🌈

  • --audit-bearer-token="" — Bearer token for Kubernetes Audit endpoint authentication. Keep it secret, keep it safe 🫶
  • --audit-endpoint="" — Kubernetes Audit endpoint URL. Setting this enables audit logging, iykyk.
  • --audit-initial-backoff="10s" — Initial backoff for Kubernetes Audit endpoint retry (default: 10s).
  • --auto-upgrade[=false] — Enable automatic upgrading of the SKS cluster control plane Kubernetes version. Set it and forget it energy.
  • --cni="calico" — CNI plugin to deploy. e.g. 'calico', or 'cilium'.
  • --description="" — SKS cluster description. Give your cluster a little lore. 📝
  • --enable-karpenter-addon[=false] — Deploy Karpenter node provisioner. Big brain move.
  • --enable-kube-proxy[=false] — Deploy the Kubernetes network proxy.
  • --exoscale-csi[=false] — Deploy the Exoscale Container Storage Interface on worker nodes. Storage girlies rise.
  • --feature-gates=[] — SKS cluster feature gates to enable.
  • -h, --help[=false] — Help for create. When in doubt, ask for help, no shame. 💖
  • --karpenter-feature-gates=[] — Karpenter feature gates to enable (only effective when the Karpenter addon is enabled).
  • --kubernetes-version="latest" — SKS cluster control plane Kubernetes version. latest is the default bestie.
  • --label=[] — SKS cluster label (format: key=value).
  • --no-cni[=false] — Do not deploy a default Container Network Interface plugin in the cluster control plane. (You're on your own for networking then, good luck 💀)
  • --no-exoscale-ccm[=false] — Do not deploy the Exoscale Cloud Controller Manager in the cluster control plane. Reminder: this can't be changed after cluster creation, so choose wisely.
  • --no-metrics-server[=false] — Do not deploy the Kubernetes Metrics Server in the cluster control plane.
  • --nodepool-anti-affinity-group=[] — Default Nodepool Anti-Affinity Group NAME|ID (can be specified multiple times).
  • --nodepool-deploy-target="" — Default Nodepool Deploy Target NAME|ID.
  • --nodepool-description="" — Default Nodepool description.
  • --nodepool-disk-size=50 — Default Nodepool Compute instances disk size.
  • --nodepool-image-gc-high-threshold=85 — Default Nodepool: the percent of disk usage after which image garbage collection is always run.
  • --nodepool-image-gc-low-threshold=80 — Default Nodepool: the percent of disk usage after which image garbage collection is never run.
  • --nodepool-image-gc-min-age="2m" — Default Nodepool: maximum age an image can be unused before it is garbage collected.
  • --nodepool-instance-prefix="" — String to prefix default Nodepool member names with.
  • --nodepool-instance-type="standard.medium" — Default Nodepool Compute instances type.
  • --nodepool-label=[] — Default Nodepool label (format: key=value).
  • --nodepool-name="" — Default Nodepool name.
  • --nodepool-nvidia-mig-profile="" — Default Nodepool Nvidia MIG profile to enable on the GPUs (e.g. 4g.24gb); the GPU family is inferred from the instance type. GPU girlies we see you 👀
  • --nodepool-private-network=[] — Default Nodepool Private Network NAME|ID (can be specified multiple times).
  • --nodepool-public-ip="" — Configures public IP assignment of the Instances (inet4|dual). (default: inet4)
  • --nodepool-security-group=[] — Default Nodepool Security Group NAME|ID (can be specified multiple times).
  • --nodepool-size=0 — Default Nodepool size. If 0, no default Nodepool will be added to the cluster. That's it, that's the vibe.
  • --nodepool-taint=[] — Kubernetes taint to apply to default Nodepool Nodes (format: KEY=VALUE:EFFECT, can be specified multiple times). Tainted, but make it fashion 💅
  • --oidc-client-id="" — OpenID client ID.
  • --oidc-groups-claim="" — OpenID JWT claim to use as the user's group.
  • --oidc-groups-prefix="" — OpenID prefix prepended to group claims.
  • --oidc-issuer-url="" — OpenID provider URL.
  • --oidc-required-claim=[] — OpenID token required claim (format: key=value).
  • --oidc-username-claim="" — OpenID JWT claim to use as the user name.
  • --oidc-username-prefix="" — OpenID prefix prepended to username claims.
  • --service-level="pro" — SKS cluster control plane service level (starter|pro). Pro is the default because you're that girl.
  • -z, --zone="" — SKS cluster zone.

🌟 OPTIONS INHERITED FROM PARENT COMMANDS 🌟

Yes bestie, these come from the parent command, they're still important, we're not skipping: 🌸

  • -C, --config="" — Specify an alternate config file [env EXOSCALE_CONFIG].
  • -O, --output-format="" — Output format (table|json|text), see "exo output --help" for more information.
  • --output-template="" — Template to use if output format is "text".
  • -Q, --quiet[=false] — Quiet mode (disable non-essential command output). For when you want peace and quiet, honestly relatable.
  • --timeout=15s — Per-zone timeout for list operations; -1s disables timeout [env EXOSCALE_TIMEOUT].
  • -A, --use-account="" — Account to use in config file [env EXOSCALE_ACCOUNT].

💜 SEE ALSO 💜

👑 HISTORY 👑

1-Jan-1980 — Auto generated by spf13/cobra. Giving vintage, but make it functional. ⭐

Okay that's the whole page, no notes. Cute little sign-off: this beauty was auto generated by spf13/cobra and dated Jan 1980 at the bottom of the original, so we're honoring that iconique little footer moment. exo(1) forever. 💖🦋✨

📦 where this page comes from