ISTIOCTL-TAG-SET(1)

📦
version 1.31.3 · 2 versions
, in nixpkgs unstable

💅 istioctl-tag-set — bestie edition 🎀

okay so this is the istioctl-tag-set(1) page, and honestly? it's giving "small command, big main character energy." we're talking revision tags for Istio control plane revisions. let's go ✨

🌸 NAME 🌸

istioctl-tag-set — create or modify revision tags 🏷️

✨ SYNOPSIS ✨

istioctl tag set  [flags]

that's it. that's the whole vibe. flags are where the fun lives, keep reading 🫶

🦋 DESCRIPTION 🦋

So what does this actually do? It creates or modifies revision tags, periodt. You tag an Istio control plane revision so you can use it with namespace istio.io/rev injection labels. That's the whole thing — you're basically giving a revision a cute little nickname the rest of the cluster can point at 💖

🎀 OPTIONS 🎀

okay this is the part you actually need, so pay attention bestie 👑

  • --auto-inject-namespaces[=false] — if you set this to true, sidecars get automatically injected into all namespaces by default. big power move, use wisely 🙈
  • -h, --help[=false] — help for set. the classic. the icon.
  • -d, --manifests="" — point this at a directory of charts and profiles (like ~/Downloads/istio-1.31.3/manifests). a literal path, not a vibe.
  • --overwrite[=false] — if true, you're allowed to overwrite revision tags. otherwise? revision tag updates that would overwrite existing revision tags get straight-up rejected. no cap, it will say no 🚫
  • -r, --revision="" — the control plane revision you want to reference from a given revision tag.
  • -y, --skip-confirmation[=false] — this one's the skipConfirmation deal: it decides whether the user gets prompted for confirmation. set it to true and you're not prompted at all — a Yes response is just assumed in all cases. zero follow-up questions, so good 😌
  • --webhook-name="" — the name to use for a revision tag's mutating webhook configuration.

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

these come from the parent, so you didn't have to do anything to get them. freebies 💜

  • --as="" — username to impersonate for the operation. could be a regular user or a service account in a namespace.
  • --as-group=[] — group to impersonate for the operation. this flag can be repeated to specify multiple groups. collect them all 🌈
  • --as-uid="" — UID to impersonate for the operation.
  • --context="" — Kubernetes configuration context.
  • -i, --istioNamespace="istio-system" — the Istio system namespace. default is istio-system, the og.
  • --kubeclient-timeout="15s" — Kubernetes client timeout as a time.Duration string, defaults to 15 seconds. 15s of patience, then we're done waiting ⏱️
  • -c, --kubeconfig="" — Kubernetes configuration file.
  • -n, --namespace="" — Kubernetes namespace.
  • --vklog=0 — number for the log level verbosity. it works like the -v flag. example: --vklog=9. yes, nine. go off 🔥

🍓 EXAMPLE 🍓

real examples, copy these exactly, do not freestyle:

  # Create a revision tag from the "1-8-0" revision
  istioctl tag set prod --revision 1-8-0

  # Point namespace "test-ns" at the revision pointed to by the "prod" revision tag
  kubectl label ns test-ns istio.io/rev=prod

  # Change the revision tag to reference the "1-8-1" revision
  istioctl tag set prod --revision 1-8-1 --overwrite

  # Make revision "1-8-1" the default revision, both resulting in that revision handling injection for "istio-injection=enabled"
  # and validating resources cluster-wide
  istioctl tag set default --revision 1-8-1

  # Rollout namespace "test-ns" to update workloads to the "1-8-1" revision
  kubectl rollout restart deployments -n test-ns

see how the first one needs no --overwrite but the second one does? that's the whole point of --overwrite, slay 💅

💀 SEE ALSO 💀

lowkey important reminder: if you're pointing at a revision tag that already exists, --overwrite is the difference between "yes queen" and "absolutely not" 🫶

and that's the page! it was Auto generated by spf13/cobra, dated Jan 1980 (yes, the date is a whole time capsule, don't ask 😭), and it's the istioctl-tag-set manual, section 1. now go tag something iconic 👑✨

📦 where this page comes from