Merge pull request #57890 from bergerhoffer/OSDOCS-4864

OSDOCS-4864: Updating CLI ref docs for 4.13

Author: bergerhoffer

modules/oc-adm-by-example-content.adoc

@@ -262,6 +262,18 @@ Collect debugging data for a given resource
 
 
 
+== oc adm migrate icsp
+Update imagecontentsourcepolicy file(s) to imagedigestmirrorset file(s).
+
+.Example usage
+[source,bash,options="nowrap"]
+----
+  # update the imagecontentsourcepolicy.yaml to new imagedigestmirrorset file under directory mydir
+  oc adm migrate icsp imagecontentsourcepolicy.yaml --dest-dir mydir
+----
+
+
+
 == oc adm migrate template-instances
 Update template instances to point to the latest group-version-kinds
 
@@ -556,7 +568,7 @@ Extract the contents of an update payload to disk
   
   # Use git to check out the source code for the current cluster release to DIR from linux/s390x image
   # Note: Wildcard filter is not supported. Pass a single os/arch to extract
-  oc adm release extract --git=DIR quay.io/openshift-release-dev/ocp-release:4.2.2 --filter-by-os=linux/s390x
+  oc adm release extract --git=DIR quay.io/openshift-release-dev/ocp-release:4.11.2 --filter-by-os=linux/s390x
 ----
 
 
@@ -571,17 +583,17 @@ Display information about a release
   oc adm release info
   
   # Show the source code that comprises a release
-  oc adm release info 4.2.2 --commit-urls
+  oc adm release info 4.11.2 --commit-urls
   
   # Show the source code difference between two releases
-  oc adm release info 4.2.0 4.2.2 --commits
+  oc adm release info 4.11.0 4.11.2 --commits
   
   # Show where the images referenced by the release are located
-  oc adm release info quay.io/openshift-release-dev/ocp-release:4.2.2 --pullspecs
+  oc adm release info quay.io/openshift-release-dev/ocp-release:4.11.2 --pullspecs
   
   # Show information about linux/s390x image
   # Note: Wildcard filter is not supported. Pass a single os/arch to extract
-  oc adm release info quay.io/openshift-release-dev/ocp-release:4.2.2 --filter-by-os=linux/s390x
+  oc adm release info quay.io/openshift-release-dev/ocp-release:4.11.2 --filter-by-os=linux/s390x
 ----
 
 
@@ -593,22 +605,22 @@ Mirror a release to a different image registry location
 [source,bash,options="nowrap"]
 ----
   # Perform a dry run showing what would be mirrored, including the mirror objects
-  oc adm release mirror 4.3.0 --to myregistry.local/openshift/release \
+  oc adm release mirror 4.11.0 --to myregistry.local/openshift/release \
   --release-image-signature-to-dir /tmp/releases --dry-run
   
   # Mirror a release into the current directory
-  oc adm release mirror 4.3.0 --to file://openshift/release \
+  oc adm release mirror 4.11.0 --to file://openshift/release \
   --release-image-signature-to-dir /tmp/releases
   
   # Mirror a release to another directory in the default location
-  oc adm release mirror 4.3.0 --to-dir /tmp/releases
+  oc adm release mirror 4.11.0 --to-dir /tmp/releases
   
   # Upload a release from the current directory to another server
   oc adm release mirror --from file://openshift/release --to myregistry.com/openshift/release \
   --release-image-signature-to-dir /tmp/releases
   
-  # Mirror the 4.3.0 release to repository registry.example.com and apply signatures to connected cluster
-  oc adm release mirror --from=quay.io/openshift-release-dev/ocp-release:4.3.0-x86_64 \
+  # Mirror the 4.11.0 release to repository registry.example.com and apply signatures to connected cluster
+  oc adm release mirror --from=quay.io/openshift-release-dev/ocp-release:4.11.0-x86_64 \
   --to=registry.example.com/your/repository --apply-release-image-signature
 ----
 
@@ -621,18 +633,18 @@ Create a new OpenShift release
 [source,bash,options="nowrap"]
 ----
   # Create a release from the latest origin images and push to a DockerHub repo
-  oc adm release new --from-image-stream=4.1 -n origin --to-image docker.io/mycompany/myrepo:latest
+  oc adm release new --from-image-stream=4.11 -n origin --to-image docker.io/mycompany/myrepo:latest
   
   # Create a new release with updated metadata from a previous release
-  oc adm release new --from-release registry.svc.ci.openshift.org/origin/release:v4.1 --name 4.1.1 \
-  --previous 4.1.0 --metadata ... --to-image docker.io/mycompany/myrepo:latest
+  oc adm release new --from-release registry.ci.openshift.org/origin/release:v4.11 --name 4.11.1 \
+  --previous 4.11.0 --metadata ... --to-image docker.io/mycompany/myrepo:latest
   
   # Create a new release and override a single image
-  oc adm release new --from-release registry.svc.ci.openshift.org/origin/release:v4.1 \
+  oc adm release new --from-release registry.ci.openshift.org/origin/release:v4.11 \
   cli=docker.io/mycompany/cli:latest --to-image docker.io/mycompany/myrepo:latest
   
   # Run a verification pass to ensure the release can be reproduced
-  oc adm release new --from-release registry.svc.ci.openshift.org/origin/release:v4.1
+  oc adm release new --from-release registry.ci.openshift.org/origin/release:v4.11
 ----
 
 

modules/oc-by-example-content.adoc

@@ -99,7 +99,7 @@ Apply a configuration to a resource by file name or stdin
   oc apply --prune -f manifest.yaml -l app=nginx
   
   # Apply the configuration in manifest.yaml and delete all the other config maps that are not in the file
-  oc apply --prune -f manifest.yaml --all --prune-whitelist=core/v1/ConfigMap
+  oc apply --prune -f manifest.yaml --all --prune-allowlist=core/v1/ConfigMap
 ----
 
 
@@ -577,7 +577,7 @@ Display merged kubeconfig settings or a specified kubeconfig file
   # Show merged kubeconfig settings
   oc config view
   
-  # Show merged kubeconfig settings and raw certificate data
+  # Show merged kubeconfig settings and raw certificate data and exposed secrets
   oc config view --raw
   
   # Get the password for the e2e user
@@ -1320,6 +1320,30 @@ Edit a resource on the server
 
 
 
+== oc events
+List events
+
+.Example usage
+[source,bash,options="nowrap"]
+----
+  # List recent events in the default namespace.
+  oc events
+  
+  # List recent events in all namespaces.
+  oc events --all-namespaces
+  
+  # List recent events for the specified pod, then wait for more events and list them as they arrive.
+  oc events --for pod/web-pod-13je7 --watch
+  
+  # List recent events in given format. Supported ones, apart from default, are json and yaml.
+  oc events -oyaml
+  
+  # List recent only events in given event types
+  oc events --types=Warning,Normal
+----
+
+
+
 == oc exec
 Execute a command in a container
 
@@ -1649,6 +1673,9 @@ Import images from a container image registry
   # Update imported data for all tags in an existing image stream
   oc import-image mystream --all
   
+  # Update imported data for a tag which points to a manifest list to include the full manifest list
+  oc import-image mystream --import-mode=PreserveOriginal
+  
   # Import all tags into a new image stream
   oc import-image mystream --from=registry.io/repo/image --all --confirm
   
@@ -2848,6 +2875,9 @@ Tag existing images into image streams
   # Tag an external container image and request pullthrough for it
   oc tag --source=docker openshift/origin-control-plane:latest yourproject/ruby:tip --reference-policy=local
   
+  # Tag an external container image and include the full manifest list
+  oc tag --source=docker openshift/origin-control-plane:latest yourproject/ruby:tip --import-mode=PreserveOriginal
+  
   # Remove the specified spec tag from an image stream
   oc tag openshift/origin-control-plane:latest -d
 ----