OC-CREATE-DEPLOYMENT(1)

📦
version 4.22.0 · 2 versions
, in nixpkgs unstable

🌸 oc create deployment — bestie edition 🌸

okay so this is the oc create deployment manpage, from the Openshift CLI User Manuals (June 2016 energy, but the vibes are eternal). no cap, this page has everything you need to spin up a deployment, and yes, that includes all 1000 inherited flags. i got you. 💅

✨ NAME ✨

oc create deployment — creates a deployment with whatever name you give it, periodt.

🎀 SYNOPSIS 🎀

oc create deployment [OPTIONS]

that's literally it. short. iconic. main character energy. ✨

🦋 DESCRIPTION 🦋

so like, this command creates a deployment with a specific name. that's the whole thing. ngl it's a whole vibe — you tell it the name, it makes the deployment happen. slay. 💖

💖 OPTIONS 💖

buckle up bestie, there's a lot here. i'm gonna walk you through every single one, no cap.

  • --allow-missing-template-keys=true — if this is true, it'll ignore any errors in templates when a field or map key is missing. only applies to golang and jsonpath output formats. lowkey a lifesaver when your template is being dramatic. 🙈
  • --dry-run="none" — must be none, server, or client. if it's a client strategy, it only prints the object that would be sent, without actually sending it — like a trial run, no commitment. if it's server strategy, it submits a server-side request without persisting the resource. fr fr, super useful for vibe-checking before you commit. ✨
  • --field-manager="kubectl-create" — the name of the manager used to track field ownership. it's giving project management energy. 💅
  • --image=[] — image names to run. a deployment can have multiple images set for a multi-container pod. so yes, you can have multiple containers in one pod. iconic. 🫶
  • -o, --output="" — output format. one of: json, yaml, kyaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file. pick your aesthetic. 🎀
  • --port=-1 — the containerPort that this deployment exposes. it's the port on the container, bestie. don't get it twisted. 🔥
  • -r, --replicas=1 — number of replicas to create. default is 1. so if you want more of the same thing (and honestly, who doesn't), this is your flag. 👑
  • --save-config=false — if true, the configuration of the current object will be saved in its annotation. otherwise, the annotation stays unchanged. this flag is useful when you want to perform kubectl apply on this object in the future. basically future-proofing. iykyk. 🌈
  • --show-managed-fields=false — if true, it keeps the managedFields when printing objects in JSON or YAML format. for the detail-obsessed besties. ⭐
  • --template="" — template string or path to a template file to use when -o=go-template, -o=go-template-file. the template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. fancy. 💜
  • --validate="ignore" — must be one of: strict (or true), warn, ignore (or false). "true" or "strict" will use a schema to validate the input and fail the request if it's invalid. it'll perform server-side validation if ServerSideFieldValidation is enabled on the api-server, but will fall back to less reliable client-side validation if not. "warn" will warn about unknown or duplicate fields without blocking the request if server-side field validation is enabled on the API server, and behave as "ignore" otherwise. "false" or "ignore" will not perform any schema validation, silently dropping any unknown or duplicate fields. ngl, ignore is the "whatever happens, happens" option. 💀

🌸 OPTIONS INHERITED FROM PARENT COMMANDS 🌸

okay so these are the flags that come from the parent command. yes, all of them. i'm not skipping a single one, bestie. 🫶

  • --as="" — username to impersonate for the operation. user could be a regular user or a service account in a namespace. it's giving "be someone else for a sec" energy. 🙈
  • --as-group=[] — group to impersonate for the operation. this flag can be repeated to specify multiple groups. so you can be in multiple groups at once. slay. ✨
  • --as-uid="" — UID to impersonate for the operation. for when you need to be very specific about who you're being. 💅
  • --as-user-extra=[] — user extras to impersonate for the operation. this flag can be repeated to specify multiple values for the same key. extra. literally. 🎀
  • --cache-dir="/homeless-shelter/.kube/cache" — default cache directory. yes, it says homeless-shelter. no, i don't know why. it's just the default, okay? 😭
  • --certificate-authority="" — path to a cert file for the certificate authority. for security girlies. 🔥
  • --client-certificate="" — path to a client certificate file for TLS. more security. more TLS. 👑
  • --client-key="" — path to a client key file for TLS. the key to the TLS kingdom. ⭐
  • --cluster="" — the name of the kubeconfig cluster to use. pick your cluster, bestie. 🌈
  • --context="" — the name of the kubeconfig context to use. context is everything. 💜
  • --disable-compression=false — if true, opt-out of response compression for all requests to the server. for when you want it raw. no compression. 💀
  • --insecure-skip-tls-verify=false — if true, the server's certificate will not be checked for validity. this will make your HTTPS connections insecure. ⚠️ do not use this unless you absolutely have to, bestie. it's literally insecure. ⚠️
  • --kubeconfig="" — path to the kubeconfig file to use for CLI requests. where's your config at? 🦋
  • --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. so many ways to turn it off. 😭
  • --match-server-version=false — require server version to match client version. for when you need them to be in sync. fr fr. ✨
  • -n, --namespace="" — if present, the namespace scope for this CLI request. put it in its place. 💅
  • --profile="none" — name of profile to capture. one of (none|cpu|heap|goroutine|threadcreate|block|mutex). for the performance girlies. 🎀
  • --profile-output="profile.pprof" — name of the file to write the profile to. profile.pprof is the default. iconic. 💖
  • --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. zero means forever, bestie. 🌸
  • -s, --server="" — the address and port of the Kubernetes API server. where's the server at? 🫶
  • --tls-server-name="" — server name to use for server certificate validation. if it's not provided, the hostname used to contact the server is used. defaults are cute. 🔥
  • --token="" — bearer token for authentication to the API server. your ticket in. 👑
  • --user="" — the name of the kubeconfig user to use. who are you today? ⭐
  • --warnings-as-errors=false — treat warnings received from the server as errors and exit with a non-zero exit code. so if the server is like "hey just a warning," you're like "nope, that's an error." dramatic but valid. 💀

🌈 EXAMPLE 🌈

okay so here are the examples. they're literally so good. i'm obsessed. 🎀

# Create a deployment named my-dep that runs the busybox image
oc create deployment my-dep --image=busybox

# Create a deployment with a command
oc create deployment my-dep --image=busybox -- date

# Create a deployment named my-dep that runs the nginx image with 3 replicas
oc create deployment my-dep --image=nginx --replicas=3

# Create a deployment named my-dep that runs the busybox image and expose port 5701
oc create deployment my-dep --image=busybox --port=5701

# Create a deployment named my-dep that runs multiple containers
oc create deployment my-dep --image=busybox:latest --image=ubuntu:latest --image=nginx

the last one? multiple containers in one deployment. it's giving "i contain multitudes." 🦋

💜 SEE ALSO 💜

that's the only one listed, bestie. but it's a good one. go check it out. ✨

⭐ HISTORY ⭐

June 2016, Ported from the Kubernetes man-doc generator. so it's old but it's still relevant. vintage. iconic. periodt. 💅

anyway, that's the whole page. every flag, every detail, every vibe. you're welcome, bestie. now go create some deployments and slay. 💖✨🎀🦋🌸💅🫶😭🔥👑🌈⭐💀🙈🍓🧚💜

— Openshift CLI User Manuals, June 2016. fr fr. 💖

📦 where this page comes from