Update readme for v1.20.0 release

Signed-off-by: Manoj Paladiya <[email protected]>

Author: Manoj Paladiya

README.md

@@ -35,14 +35,14 @@ There are two ways to obtain the plugin
 
 ### Download from IBM container registry
 
-The plugin is also provided in a container image `cp.icr.io/cpopen/cpfs/ibm-pak:TAG` where `TAG` should be replaced with the corresponding plugin version, for example `cp.icr.io/cpopen/cpfs/ibm-pak:v1.19.1` will have `v1.19.1` of the plugin.
+The plugin is also provided in a container image `cp.icr.io/cpopen/cpfs/ibm-pak:TAG` where `TAG` should be replaced with the corresponding plugin version, for example `cp.icr.io/cpopen/cpfs/ibm-pak:v1.20.0` will have `v1.20.0` of the plugin.
 
 The following command will create a container and copy the plug-ins for all the supported platforms in a directory, `plugin-dir`. You can specify any directory name and it will be created while copying. After copying, it will delete the temporary container. The `plugin-dir` will have all the binaries and other artifacts you find in a Github release and repo at [IBM/ibm-pak](https://github.com/IBM/ibm-pak). For example,
 
 1. If you use docker:
 
 ```
-id=$(docker create cp.icr.io/cpopen/cpfs/ibm-pak:v1.19.1 - )
+id=$(docker create cp.icr.io/cpopen/cpfs/ibm-pak:v1.20.0 - )
 docker cp $id:/ibm-pak-plugin plugin-dir
 docker rm -v $id
 cd plugin-dir
@@ -51,7 +51,7 @@ cd plugin-dir
 2. If you podman:
 
 ```
-id=$(podman create cp.icr.io/cpopen/cpfs/ibm-pak:v1.19.1 - )
+id=$(podman create cp.icr.io/cpopen/cpfs/ibm-pak:v1.20.0 - )
 podman cp $id:/ibm-pak-plugin plugin-dir
 podman rm -v $id
 cd plugin-dir

docs/command-help.md

@@ -386,6 +386,7 @@ Flags:
                                    
   -h, --help                       help for get
       --install-method string      Install method to generate manifests as per install type. One of: [OLM, helm] (default "OLM")
+      --resolve-unique-dependencies   if provided, check for duplicate versions and resolve exact one suitable version of sub-CASE (optional)
       --skip-dependencies          skip downloading dependencies (optional)
       --skip-verify                if provided, skips the certification verification (optional)
       --version string             the "semantic version range" specifying the CASE to download, e.g. '2.0.0' or '>=1.0.0, <=3.0.0' (optional - assumes latest if not provided)
@@ -424,6 +425,11 @@ Example:
   oc ibm-pak get ibm-my-cloudpak --version 1.0.0 --install-method helm
   ```
 
+- Download a CASE with unique sub-CASE version (most suitable) when multiple versions of sub-CASE found (Supported with ibm-pak version `v1.20.0` or higher)
+  ```
+  oc ibm-pak get ibm-my-cloudpak --version 1.0.0 --resolve-unique-dependencies
+  ```
+
 # ibm-pak generate mirror-manifests
 Generate mirror manifests for a CASE
 
@@ -637,10 +643,14 @@ Usage:
 oc ibm-pak list
 
 Flags:
-      --case-name string   print the list of all CASE images (separately printed for each version) matching the given case name
-      --downloaded         print the list of downloaded CASE images available locally
-  -h, --help               help for list
-  -o, --output string      Specify output format as json, yaml or ""
+      --case-name string      print the list of all CASE images (separately printed for each version) matching the given case name
+      --case-version string   list helm charts of given CASE
+      --chart-name string     list helm charts versions of given chart
+      --chart-repo string     Chart repository
+      --charts                list helm charts available in provided repository or downloaded locally
+      --downloaded            print the list of downloaded CASE images available locally
+  -h, --help                  help for list
+  -o, --output string         Specify output format as json, yaml or ""
 ```
 
 Example:
@@ -686,6 +696,42 @@ Example:
   oc ibm-pak list --case-name ibm-my-cloudpak --downloaded -o yaml
   ```
 
+- List all Charts available in the provided chart repository (Supported with ibm-pak version `v1.20.0` or higher)
+  ```
+  oc ibm-pak list --charts --chart-repo https://github.com/IBM/charts/raw/master/repo/ibm-helm/
+  ```
+
+- List all Charts in json output (Supported with ibm-pak version `v1.20.0` or higher)
+  ```
+  oc ibm-pak list --charts --chart-repo https://github.com/IBM/charts/raw/master/repo/ibm-helm/ -o json
+  ```
+
+- List all Charts in yaml output (Supported with ibm-pak version `v1.20.0` or higher)
+  ```
+  oc ibm-pak list --charts --chart-repo https://github.com/IBM/charts/raw/master/repo/ibm-helm/ -o yaml
+  ```
+
+- List all versions of Chart for a specific chart name (Supported with ibm-pak version `v1.20.0` or higher)
+  ```
+  oc ibm-pak list --charts --chart-name ibm-appconnect-operator --chart-repo https://github.com/IBM/charts/raw/master/repo/ibm-helm/
+  ```
+
+- List all downloaded Charts from ibm-pak workspace (Supported with ibm-pak version `v1.20.0` or higher)
+  ```
+  oc ibm-pak list --charts --downloaded
+  ```
+
+- List all downloaded Charts for a CASE (Supported with ibm-pak version `v1.20.0` or higher)
+  ```
+  oc ibm-pak list --charts --case-name ibm-cert-manager --downloaded
+  ```
+
+- List all downloaded Charts for a CASE for specific version (Supported with ibm-pak version `v1.20.0` or higher)
+  ```
+  oc ibm-pak list --charts --case-name ibm-cert-manager --case-version 4.2.15 --downloaded
+  ```
+  
+
 # ibm-pak verify
 Verify the integrity of downloaded CASEs
 

docs/download-github.md

@@ -21,72 +21,72 @@
 Example using `curl`:
 
 ```
-curl -L https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-darwin-amd64.tar.gz -o oc-ibm_pak-darwin-amd64.tar.gz
-curl -L https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-darwin-amd64.tar.gz.sig -o oc-ibm_pak-darwin-amd64.tar.gz.sig
+curl -L https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-darwin-amd64.tar.gz -o oc-ibm_pak-darwin-amd64.tar.gz
+curl -L https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-darwin-amd64.tar.gz.sig -o oc-ibm_pak-darwin-amd64.tar.gz.sig
 ```
 
 Example using `wget`:
 
 ```
-wget https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-darwin-amd64.tar.gz
-wget https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-darwin-amd64.tar.gz.sig
+wget https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-darwin-amd64.tar.gz
+wget https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-darwin-amd64.tar.gz.sig
 ```
 
 ## Linux x86-architecture
 
 Example using `curl`:
 
 ```
-curl -L https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-amd64.tar.gz -o oc-ibm_pak-linux-amd64.tar.gz
-curl -L https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-amd64.tar.gz.sig -o oc-ibm_pak-linux-amd64.tar.gz.sig
+curl -L https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-amd64.tar.gz -o oc-ibm_pak-linux-amd64.tar.gz
+curl -L https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-amd64.tar.gz.sig -o oc-ibm_pak-linux-amd64.tar.gz.sig
 ```
 
 Example using `wget`:
 
 ```
-wget https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-amd64.tar.gz
-wget https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-amd64.tar.gz.sig
+wget https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-amd64.tar.gz
+wget https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-amd64.tar.gz.sig
 ```
 
 ## Linux ppc64le-architecture
 
 Example using `curl`:
 
 ```
-curl -L https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-ppc64le.tar.gz -o oc-ibm_pak-linux-ppc64le.tar.gz
-curl -L https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-ppc64le.tar.gz.sig -o oc-ibm_pak-linux-ppc64le.tar.gz.sig
+curl -L https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-ppc64le.tar.gz -o oc-ibm_pak-linux-ppc64le.tar.gz
+curl -L https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-ppc64le.tar.gz.sig -o oc-ibm_pak-linux-ppc64le.tar.gz.sig
 ```
 
 Example using `wget`:
 
 ```
-wget https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-ppc64le.tar.gz
-wget https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-ppc64le.tar.gz.sig
+wget https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-ppc64le.tar.gz
+wget https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-ppc64le.tar.gz.sig
 ```
 
 ## Linux s390x-architecture
 
 Example using `curl`:
 
 ```
-curl -L https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-s390x.tar.gz -o oc-ibm_pak-linux-s390x.tar.gz
-curl -L https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-s390x.tar.gz.sig -o oc-ibm_pak-linux-s390x.tar.gz.sig
+curl -L https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-s390x.tar.gz -o oc-ibm_pak-linux-s390x.tar.gz
+curl -L https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-s390x.tar.gz.sig -o oc-ibm_pak-linux-s390x.tar.gz.sig
 ```
 
 Example using `wget`:
 
 ```
-wget https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-s390x.tar.gz
-wget https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-linux-s390x.tar.gz.sig
+wget https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-s390x.tar.gz
+wget https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-linux-s390x.tar.gz.sig
 ```
 
 ## Windows
 
 Example (from PowerShell) using `curl`:
 
 ```
-curl https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-windows-amd64.tar.gz -o oc-ibm_pak-windows-amd64.tar.gz
-curl https://github.com/IBM/ibm-pak/releases/download/v1.19.1/oc-ibm_pak-windows-amd64.tar.gz.sig -o oc-ibm_pak-windows-amd64.tar.gz.sig
+curl https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-windows-amd64.tar.gz -o oc-ibm_pak-windows-amd64.tar.gz
+curl https://github.com/IBM/ibm-pak/releases/download/v1.20.0/oc-ibm_pak-windows-amd64.tar.gz.sig -o oc-ibm_pak-windows-amd64.tar.gz.sig
 ```
 
 # Download public keys for ibm-pak versions less than v1.5.0