OC(1)

📦
version 4.22.0 · 2 versions
, in nixpkgs unstable

💅 OC(1) — the oc kustomize era

okay so bestie, welcome to oc, the OpenShift CLI (this page is OC(1) if you're keeping receipts 🧾). Today's main character is the kustomize subcommand and it is literally here to build stuff for you. Buckle up 🎀

✨ NAME ✨

oc kustomize — build a kustomization target from a directory or URL 🦋

🌸 SYNOPSIS 🌸

oc kustomize [OPTIONS]

💖 DESCRIPTION 💖

So what it does: it builds a set of KRM resources using a kustomization.yaml file. No cap, that's the whole vibe.

The DIR argument has to be a path to a directory containing kustomization.yaml, or a git repository URL with a path suffix that points at the same thing relative to the repo root. And if you just... omit DIR? '.' is assumed. She assumes. Iconic 💅

✨ OPTIONS ✨

  • --as-current-user=false — use the uid and gid of whoever's running the command to run the function in the container 🫶
  • --enable-alpha-plugins=false — enable kustomize plugins ✨
  • --enable-helm=false — enable use of the Helm chart inflator generator 🎀
  • -e, --env=[] — a list of environment variables to be used by functions 🌸
  • --helm-api-versions=[] — Kubernetes api versions used by Helm for Capabilities.APIVersions
  • --helm-command="helm" — helm command (path to executable) 👑
  • --helm-debug=false — enable debug output from the Helm chart inflator generator 🐛
  • --helm-kube-version="" — Kubernetes version used by Helm for Capabilities.KubeVersion
  • --load-restrictor="LoadRestrictionsRootOnly" — if you set this to 'LoadRestrictionsNone', local kustomizations may load files from outside their root. Sounds fun? It does, however, break the relocatability of the kustomization 💀 so like, know what you're doing
  • --mount=[] — a list of storage options read from the filesystem 🍓
  • --network=false — enable network access for functions that declare it 🌈
  • --network-name="bridge" — the docker network to run the container in
  • -o, --output="" — if specified, write output to this path ✨

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

(yeah she got them from her parent commands, it's giving family business 👑

  • --as="" — username to impersonate for the operation. User 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
  • --as-uid="" — UID to impersonate for the operation
  • --as-user-extra=[] — user extras to impersonate for the operation. This flag can be repeated to specify multiple values for the same key 🔑
  • --cache-dir="/homeless-shelter/.kube/cache" — default cache directory 📁
  • --certificate-authority="" — path to a cert file for the certificate authority
  • --client-certificate="" — path to a client certificate file for TLS
  • --client-key="" — path to a client key file for TLS 🔐
  • --cluster="" — the name of the kubeconfig cluster to use
  • --context="" — the name of the kubeconfig context to use
  • --disable-compression=false — if true, opt-out of response compression for all requests to the server
  • --insecure-skip-tls-verify=false — if true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure 😭 please be careful bestie
  • --kubeconfig="" — path to the kubeconfig file to use for CLI requests
  • --kuberc="" — path to the kuberc file to use for preferences. This can be disabled by exporting KUBECTL_KUBERC=false feature gate or turning off the feature KUBERC=off 🎀
  • --match-server-version=false — require server version to match client version
  • -n, --namespace="" — if present, the namespace scope for this CLI request
  • --profile="none" — name of profile to capture. One of (none|cpu|heap|goroutine|threadcreate|block|mutex) 📊
  • --profile-output="profile.pprof" — name of the file to write the profile to
  • --request-timeout="0" — the length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests ⏰
  • -s, --server="" — the address and port of the Kubernetes API server
  • --tls-server-name="" — server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used
  • --token="" — bearer token for authentication to the API server 🔑
  • --user="" — the name of the kubeconfig user to use
  • --warnings-as-errors=false — treat warnings received from the server as errors and exit with a non-zero exit code 💀

🔥 EXAMPLE 🔥

# Build the current working directory
oc kustomize

# Build some shared configuration directory
oc kustomize /home/config/production

# Build from github
oc kustomize https://github.com/kubernetes-sigs/kustomize.git/examples/helloWorld?ref=v1.0.6

like, look at her go 🏃‍♀️💨

👑 SEE ALSO 👑

oc(1),

(that's it. that's the list. short and sweet, iykyk 💅)

💜 HISTORY 💜

June 2016, ported from the Kubernetes man-doc generator 🌈 — girl's been around a while, respect the elders fr fr

and that's the whole page bestie 🫶✨ love u, go build something iconic 💖

— sign-off era: Openshift · Openshift CLI User Manuals · OC(1) · dated June 2016 🎀💜

📦 where this page comes from