OC-CREATE-BUILD(1)

📦
version 4.22.0 · 2 versions
, in nixpkgs unstable

🎀 OC CREATE(1) 🎀

ok so this is a page from the Openshift CLI User Manuals (yes, the whole manual, bestie — we're just doing one lil command out of it) and it's giving "June 2016 but make it eternal." Sit down, grab a boba, we're learning oc create build. 💅

✨ NAME ✨

oc create build — literally just creating a new build. That's the whole vibe.

✨ SYNOPSIS ✨

oc create build [OPTIONS]

🌸 DESCRIPTION 🌸

So like. You're creating a new build. That's it, that's the tweet.

But for context, since we're being thorough: builds create container images from source code or Dockerfiles. A build can pull source code from Git, or it can accept a Dockerfile that pulls the source content. Two paths, one iconic destiny. 🦋

💖 OPTIONS 💖

okay this is the long part, but stay with me, every single flag matters:

  • --allow-missing-template-keys=true — if true, ignore any errors in templates when a field or map key is missing from the template. Heads up: this only applies to golang and jsonpath output formats.
  • --build-loglevel=0 — sets the log level for builds. Range is 0-10, and 0 is the default. 🗣️
  • --context-dir="" — a relative path within the repository to use as the root of the build.
  • --dockerfile-contents="" — the actual contents of a Dockerfile to build.
  • --dockerfile-path="" — the relative path within the repository context where the Dockerfile lives.
  • --dry-run="none" — must be "none", "server", or "client". If it's the client strategy, only print the object that would be sent, without sending it. If it's the server strategy, submit the server-side request without persisting the resource. (Look at you being all responsible, not committing. 🫶)
  • --env=[] — add environment variables to the build strategy.
  • --from-image="" — a container image pull spec to use as the basis for the image build.
  • --image-optimization-policy="" — controls whether individual layers are created. Your options are SkipLayers, SkipLayersAndWarn, or None.
  • -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 fighter. ✨
  • --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. Future-you says thank you.
  • --show-managed-fields=false — if true, keep the managedFields when printing objects in JSON or YAML format.
  • --source-git="" — a URL or Git spec link to a Git repository.
  • --source-revision="" — a commit, branch, or tag within the source repository.
  • --strategy="" — the build strategy to use: Docker, Source, or Custom. Can be defaulted by other arguments, so don't stress too hard.
  • --template="" — template string or path to 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].
  • --to-image="" — a location to push the output image to.
  • --to-image-stream="" — an image stream tag to push the output image to. Accepts [NAMESPACE/]STREAM:TAG.

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

these are the ones you didn't ask for but got anyway, like a goodie bag:

  • --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. (yes that path is real, we don't make the rules 😭)
  • --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. ⚠️ like, actually read that one twice, 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 🔥

the moment you've all been waiting for:

# Create a new build
oc create build myapp

ate. no crumbs. 👑

🌈 SEE ALSO 🌈

oc-create(1), — go read that one too, iykyk.

💜 HISTORY 💜

June 2016, Ported from the Kubernetes man-doc generator. an elder. a legend. we respect her.

aaaand that's the page!! 🍓 this whole thing came to you courtesy of Openshift and the Openshift CLI User Manuals, dated June 2016 — mwah, drink water, and go create a build bestie 💖✨🦋

📦 where this page comes from