v1.5.2-rc.0

Tanzu CLI Installation Instructions

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow the
instructions.

Changes by Kind

🐛 Bug Fixes

• kubecontext constructed on successful tanzu login will incorporate custom cert or skip verification flag from the cert map if neither are explicitly provided in the command invocation. (#829, @vuil )
• Do not hide remapped subcommands when the plugin's root command is hidden. (#831, @marckhouzam)

✨ Improvements

• Improve CLI execution speed, especially for shell completion responsiveness (#821, @marckhouzam)
• Improve shell completion debugging by showing debug printouts. (#827, @marckhouzam)
• Support building multiple RPM packages to be used with different signing keys. (#837, @marckhouzam)

Dependencies

Added

• cloud.google.com/go/auth/oauth2adapt: v0.2.4
• cloud.google.com/go/auth: v0.9.3
• cuelabs.dev/go/oci/ociregistry: a39bec0
• github.com/AliyunContainerService/ack-ram-tool/pkg/credentials/provider: v0.14.0
• github.com/Azure/azure-sdk-for-go/sdk/azcore: v1.14.0
• github.com/Azure/azure-sdk-for-go/sdk/azidentity: v1.7.0
• github.com/Azure/azure-sdk-for-go/sdk/internal: v1.10.0
• github.com/Azure/azure-sdk-for-go/sdk/security/keyvault/azkeys: v1.1.0
• github.com/Azure/azure-sdk-for-go/sdk/security/keyvault/internal: v1.0.0
• github.com/AzureAD/microsoft-authentication-library-for-go: v1.2.2
• github.com/DATA-DOG/go-sqlmock: v1.5.2
• github.com/alessio/shellescape: v1.4.1
• github.com/antlr4-go/antlr/v4: v4.13.0
• github.com/aws/aws-sdk-go-v2/feature/s3/manager: v1.16.9
• github.com/bufbuild/protocompile: v0.10.0
• github.com/buildkite/go-pipeline: v0.13.1
• github.com/buildkite/interpolate: v0.1.3
• github.com/buildkite/roko: v1.2.0
• github.com/cavaliergopher/cpio: v1.0.1
• github.com/cockroachdb/apd/v3: v3.2.1
• github.com/go-ini/ini: v1.67.0
• github.com/go-jose/go-jose/v4: v4.0.4
• github.com/go-task/slim-sprig/v3: v3.0.0
• github.com/golang-jwt/jwt/v5: v5.2.1
• github.com/google/flatbuffers: v2.0.8+incompatible
• github.com/google/gnostic-models: c7be7c7
• github.com/google/go-github/v55: v55.0.0
• github.com/in-toto/attestation: v1.1.0
• github.com/jmoiron/sqlx: v1.3.5
• github.com/klauspost/pgzip: v1.2.6
• github.com/letsencrypt/borp: 6cc6ce5
• github.com/letsencrypt/validator/v10: a0c7dfc
• github.com/magefile/mage: v1.14.0
• github.com/matttproud/golang_protobuf_extensions/v2: v2.0.0
• github.com/nats-io/nats.go: v1.34.0
• github.com/nats-io/nkeys: v0.4.7
• github.com/nats-io/nuid: v1.0.1
• github.com/nozzle/throttler: 2ea9822
• github.com/oleiade/reflections: v1.1.0
• github.com/poy/onpar: v1.1.2
• github.com/sagikazarmark/locafero: v0.4.0
• github.com/sagikazarmark/slog-shim: v0.1.0
• github.com/sassoftware/relic/v7: v7.6.2
• github.com/sigstore/sigstore-go: v0.6.1
• github.com/sigstore/sigstore/pkg/signature/kms/aws: v1.8.8
• github.com/sigstore/sigstore/pkg/signature/kms/azure: v1.8.8
• github.com/sigstore/sigstore/pkg/signature/kms/gcp: v1.8.8
• github.com/sigstore/sigstore/pkg/signature/kms/hashivault: v1.8.8
• github.com/sourcegraph/conc: v0.3.0
• github.com/theupdateframework/go-tuf/v2: v2.0.1
• github.com/ysmood/got: v0.40.0
• google.golang.org/genproto/googleapis/api: 7e3bb23
• google.golang.org/genproto/googleapis/rpc: 8af14fe
• gopkg.in/evanphx/json-patch.v4: v4.12.0
• gopkg.in/go-jose/go-jose.v2: v2.6.3
• k8s.io/gengo/v2: 51d4e06
• software.sslmate.com/src/go-pkcs12: v0.4.0

Changed

• bitbucket.org/creachadair/shell: v0.0.7 → v0.0.8
• cloud.google.com/go/compute/metadata: v0.2.3 → v0.5.0
• cloud.google.com/go/compute: v1.19.1 → v1.25.1
• cloud.google.com/go/firestore: v1.9.0 → v1.15.0
• cloud.google.com/go/iam: v0.13.0 → v1.2.0
• cloud.google.com/go/kms: v1.10.2 → v1.19.0
• cloud.google.com/go/longrunning: v0.4.1 → v0.6.0
• cloud.google.com/go/monitoring: v1.13.0 → v1.18.0
• cloud.google.com/go/profiler: v0.3.1 → v0.4.0
• cloud.google.com/go/pubsub: v1.30.0 → v1.37.0
• cloud.google.com/go/security: v1.14.0 → v1.15.5
• cloud.google.com/go/storage: v1.29.0 → v1.39.1
• cloud.google.com/go/trace: v1.9.0 → v1.10.5
• cuelang.org/go: v0.5.0 → v0.9.2
• filippo.io/edwards25519: v1.0.0 → v1.1.0
• github.com/AdamKorcz/go-fuzz-headers-1: 12e09ab → 8b5d3ce
• github.com/Azure/go-ansiterm: d185dfc → 306776e
• github.com/Azure/go-autorest/autorest/adal: v0.9.22 → v0.9.23
• github.com/Microsoft/go-winio: v0.6.1 → v0.6.2
• github.com/ProtonMail/go-crypto: 7d5c6f0 → afb1ddc
• github.com/adrg/xdg: v0.4.0 → v0.5.3
• github.com/alibabacloud-go/darabonba-openapi: v0.1.18 → v0.2.1
• github.com/alibabacloud-go/debug: 9472017 → v1.0.0
• github.com/alibabacloud-go/openapi-util: v0.0.11 → v0.1.0
• github.com/alibabacloud-go/tea-utils: v1.4.4 → v1.4.5
• github.com/alibabacloud-go/tea-xml: v1.1.2 → v1.1.3
• github.com/alibabacloud-go/tea: v1.1.18 → v1.2.1
• github.com/aliyun/credentials-go: v1.2.3 → v1.3.2
• github.com/armon/go-metrics: v0.4.0 → v0.4.1
• github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream: v1.4.3 → v1.6.2
• github.com/aws/aws-sdk-go-v2/config: v1.18.23 → v1.27.33
• github.com/aws/aws-sdk-go-v2/credentials: v1.13.22 → v1.17.32
• github.com/aws/aws-sdk-go-v2/feature/ec2/imds: v1.13.3 → v1.16.13
• github.com/aws/aws-sdk-go-v2/internal/configsources: v1.1.33 → v1.3.17
• github.com/aws/aws-sdk-go-v2/internal/endpoints/v2: v2.4.27 → v2.6.17
• github.com/aws/aws-sdk-go...

v1.5.1

Tanzu CLI Installation Instructions

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow the
instructions.

Changes by Kind

✨ Features

• Add support to generate API token with tanzu api-token create (supported for UAA as IDP) (#820, @anujc25)
• Token obtained from the "api-token create" command can be used as value to environment variable TANZU_API_TOKEN to connect to uaa-based endpoint (#819, @vuil)

📄 Documentation

• Update docs to use new tanzu-cli-installer-packages repo for APT/RPM packages and new Public Key (#816, @anujc25)

Dependencies

Added

Nothing has changed.

Changed

• github.com/docker/docker: v24.0.9+incompatible → v25.0.6+incompatible
• github.com/fatih/color: v1.15.0 → v1.16.0
• github.com/hashicorp/go-hclog: v1.3.1 → v1.6.3
• github.com/hashicorp/go-retryablehttp: v0.7.2 → v0.7.7
• github.com/mattn/go-isatty: v0.0.17 → v0.0.20
• golang.org/x/sys: v0.18.0 → v0.20.0

Removed

Nothing has changed.

v1.5.0

Tanzu CLI Installation Instructions

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow these instructions.

📢 Important Update: APT/YUM Package Location and Signing Key Change

With the release of Tanzu CLI v1.5.0, we have introduced changes to the package location and signing key for APT (Debian/Ubuntu) and YUM/DNF (RHEL) packages.

Changes:

• Packages are now published to a new location: https://storage.googleapis.com/tanzu-cli-installer-packages
• Packages are signed with a new key and public key is available at location: https://storage.googleapis.com/tanzu-cli-installer-packages/keys/TANZU-PACKAGING-GPG-RSA-KEY.gpg

Action Required:

To ensure uninterrupted access to Tanzu CLI packages, please update your automation scripts or manual installation procedures to account for the the new package location and signing key. Updated installation instructions are as follows:

APT (Debian/Ubuntu)

sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://storage.googleapis.com/tanzu-cli-installer-packages/keys/TANZU-PACKAGING-GPG-RSA-KEY.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-installer-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install -y tanzu-cli

YUM/DNF (RHEL)

cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-installer-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://storage.googleapis.com/tanzu-cli-installer-packages/keys/TANZU-PACKAGING-GPG-RSA-KEY.gpg
EOF

sudo yum install -y tanzu-cli # dnf install can also be used

The installation procedures for Homebrew, Chocolatey and ASDF package managers remain the same.

Changes by Kind

✨ Features

• Add support for using UAA as IDP
  • Add support for using UAA as IDP. After this change, endpoint URIs provided when creating a 'tanzu' context not recognized as public Tanzu SaaS endpoint will default to use UAA as IDP. Use --force-csp boolean flag to override behavior for custom endpoints that still requires CSP. (#802, @vuil)
  • Add support for custom CA cert or explicit skipping of cert validation for UAA-based tanzu platform. (#803, @vuil)
  • Allow to specify a tanzu endpoint with no scheme (#811, @marckhouzam)
  • Enable TANZU_CLI_SM_ORGANIZATION_NAME TANZU_CLI_SM_ORGANIZATION_ID to configure the Org name and id of a self-managed Tanzu Platform environment. (#804, @vuil)
  • Fix incorrect context name being created when using new tanzu platform endpoints (#808, @anujc25)
  • Fix missing org name in browser login (#812, @marckhouzam)
  • Streamline UAA-based Tanzu Platform login to not require Org ID (#815, @vuil)
  • Properly support the use of custom ca cert data for tanzu type CLI contexts. (#805, @vuil)
• Support for upcoming Tanzu Platform Endpoint Changes
  • Read default database refresh threshold from Central Config (#809, @anujc25)
  • Use Central Configuration to get/configure/update Tanzu Platform endpoints and implement Fallback algorithm to find service endpoints (#801, @anujc25)

📄 Documentation

• Document how to show the context in the user's prompt. (#806, @marckhouzam)

Dependencies

Added

• github.com/99designs/gqlgen: v0.17.44
• github.com/andreyvit/diff: c7f18ee
• github.com/arbovm/levenshtein: 48b4e1c
• github.com/bradleyjkemp/cupaloy/v2: v2.6.0
• github.com/dgryski/trifles: dd97f9a
• github.com/hashicorp/golang-lru/v2: v2.0.7
• github.com/pkg/diff: 20ebb0f
• github.com/sosodev/duration: v1.2.0

Changed

• github.com/chzyer/logex: v1.1.10 → v1.2.0
• github.com/chzyer/test: a1ea475 → 0614579
• github.com/vmware-tanzu/tanzu-plugin-runtime: v1.4.2 → v1.4.4

Removed

Nothing has changed.

v1.5.0-rc.1

Tanzu CLI Installation Instructions

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow the
instructions.

Changes by Kind

Miscellaneous

• Add support for custom CA cert or explicit skipping of cert validation for UAA-based tanzu platform. (#803, @vuil)
• Add support for using UAA as IDP. After this change, endpoint URIs provided when creating a 'tanzu' context not recognized as public Tanzu SaaS endpoint will default to use UAA as IDP. Use --force-csp boolean flag to override behavior for custom endpoints that still requires CSP. (#802, @vuil)
• Allow to specify a tanzu endpoint with no scheme (#811, @marckhouzam)
• Document how to show the context in the user's prompt. (#806, @marckhouzam)
• Enable TANZU_CLI_SM_ORGANIZATION_NAME TANZU_CLI_SM_ORGANIZATION_ID to configure the Org name and id of a self-managed Tanzu Platform environment. (#804, @vuil)
• Fix incorrect context name being created when using new tanzu platform endpoints (#808, @anujc25)
• Fix missing org name in browser login (#812, @marckhouzam)
• Properly support the use of custom ca cert data for tanzu type CLI contexts. (#805, @vuil)
• Read default database refresh threshold from Central Config (#809, @anujc25)
• Streamline UAA-based Tanzu Platform login to not require Org ID (#815, @vuil)
• Use Central Configuration to get/configure/update Tanzu Platform endpoints and implement Fallback algorithm to find service endpoints (#801, @anujc25)

Dependencies

Added

• github.com/99designs/gqlgen: v0.17.44
• github.com/andreyvit/diff: c7f18ee
• github.com/arbovm/levenshtein: 48b4e1c
• github.com/bradleyjkemp/cupaloy/v2: v2.6.0
• github.com/dgryski/trifles: dd97f9a
• github.com/hashicorp/golang-lru/v2: v2.0.7
• github.com/pkg/diff: 20ebb0f
• github.com/sosodev/duration: v1.2.0

Changed

• github.com/chzyer/logex: v1.1.10 → v1.2.0
• github.com/chzyer/test: a1ea475 → 0614579
• github.com/vmware-tanzu/tanzu-plugin-runtime: v1.4.2 → v1.4.4

Removed

Nothing has changed.

v1.5.0-rc.0

Tanzu CLI Installation Instructions

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow the
instructions.

Changes by Kind

✨ Features

• Read default database refresh threshold from Central Config (#809, @anujc25)

🐛 Bug Fixes

• Allow to specify a tanzu endpoint with no scheme (#811, @marckhouzam)
• Fix missing org name in browser login (#812, @marckhouzam)
• Fix incorrect context name being created when using new tanzu platform endpoints (#808, @anujc25)

v1.5.0-alpha.2

Tanzu CLI Installation Instructions

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow the
instructions.

For installing the Tanzu CLI through various package managers, please follow the appropriate "Installing a Pre-Release" sections on the same page.

Changes by Kind

Miscellaneous

• Add support for custom CA cert or explicit skipping of cert validation for UAA-based tanzu platform. (#803, @vuil)
• Add support for using UAA as IDP. After this change, endpoint URIs provided when creating a 'tanzu' context not recognized as public Tanzu SaaS endpoint will default to use UAA as IDP. Use --force-csp boolean flag to override behavior for custom endpoints that still requires CSP. (#802, @vuil)
• Enable TANZU_CLI_SM_ORGANIZATION_NAME TANZU_CLI_SM_ORGANIZATION_ID to configure the Org name and id of a self-managed Tanzu Platform environment. (#804, @vuil)
• Properly support the use of custom ca cert data for tanzu type CLI contexts. (#805, @vuil)
• Use Central Configuration to get/configure/update Tanzu Platform endpoints and implement Fallback algorithm to find service endpoints (#801, @anujc25)

Dependencies

Added

• github.com/99designs/gqlgen: v0.17.44
• github.com/andreyvit/diff: c7f18ee
• github.com/arbovm/levenshtein: 48b4e1c
• github.com/bradleyjkemp/cupaloy/v2: v2.6.0
• github.com/dgryski/trifles: dd97f9a
• github.com/hashicorp/golang-lru/v2: v2.0.7
• github.com/pkg/diff: 20ebb0f
• github.com/sosodev/duration: v1.2.0

Changed

• github.com/chzyer/logex: v1.1.10 → v1.2.0
• github.com/chzyer/test: a1ea475 → 0614579
• github.com/vmware-tanzu/tanzu-plugin-runtime: v1.4.2 → v1.4.4

Removed

Nothing has changed.

v1.5.0-alpha.0

Tanzu CLI Installation Instructions

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow the
instructions.

For installing the Tanzu CLI through various package managers, please follow the appropriate "Installing a Pre-Release" sections on the same page.

Changes by Kind

Miscellaneous

• Add support for custom CA cert or explicit skipping of cert validation for UAA-based tanzu platform. (#803, @vuil)
• Add support for using UAA as IDP. After this change, endpoint URIs provided when creating a 'tanzu' context not recognized as public Tanzu SaaS endpoint will default to use UAA as IDP. Use --force-csp boolean flag to override behavior for custom endpoints that still requires CSP. (#802, @vuil)
• Use Central Configuration to get/configure/update Tanzu Platform endpoints and implement Fallback algorithm to find service endpoints (#801, @anujc25)

Dependencies

Added

• github.com/99designs/gqlgen: v0.17.44
• github.com/andreyvit/diff: c7f18ee
• github.com/arbovm/levenshtein: 48b4e1c
• github.com/bradleyjkemp/cupaloy/v2: v2.6.0
• github.com/dgryski/trifles: dd97f9a
• github.com/hashicorp/golang-lru/v2: v2.0.7
• github.com/pkg/diff: 20ebb0f
• github.com/sosodev/duration: v1.2.0

Changed

• github.com/chzyer/logex: v1.1.10 → v1.2.0
• github.com/chzyer/test: a1ea475 → 0614579
• github.com/vmware-tanzu/tanzu-plugin-runtime: v1.4.2 → v1.4.4

Removed

Nothing has changed.

v1.4.1

Tanzu CLI Installation Instructions

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow the instructions.

Users are advised to uninstall older pre-release versions of the Tanzu CLI prior to installing this version.

Changes by Kind

🐛 Bug Fixes

• Fix the file locking issue on Windows (#797, @anujc25)
• Update TMC endpoint mapping rules for the Tanzu context (#798, @anujc25)

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow the instructions.

Dependencies

Added

Nothing has changed.

Changed

• github.com/vmware-tanzu/tanzu-plugin-runtime: v1.4.1 → v1.4.2

Removed

Nothing has changed.

v1.4.0

Tanzu CLI Installation Instructions

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow the instructions.

Users are advised to uninstall older pre-release versions of the Tanzu CLI prior to installing this version.

Changes by Kind

✨ Features

• Add official support for the asdf package manager (MacOS and Linux) (#787, @marckhouzam)
• Add support to update the CSP issuer to TCSP (#793, @prkalle)
• Deprecate the plugin invocation form tanzu kubernetes <plugin> in favor of the shorter and more consistent tanzu <plugin> (#781, @marckhouzam)
• Hide the tanzu init command which is no longer performing any actual initialization. (#773, @marckhouzam)
• Respect command mapping for the help command for plugins (#777, @marckhouzam)
• Support Activating plugins on Plugin Group Publish/Activation (#794, @anujc25)
• Support entry-specific active context type check in command mapping (#783, @vuil)

📄 Documentation

• Document details about ARM64 support. (#776, @marckhouzam)
• Update packages.vmware.com to packages-prod.broadcom.com (#780, @marckhouzam)

🐛 Bug Fixes

• Show the description of the latest (instead of oldest) version of a plugin in the tanzu plugin search output. (#769, @marckhouzam)
• Respect command mapping for the help command for plugins (#777, @marckhouzam)

Dependencies

Added

• github.com/alexflint/go-filemutex: v1.3.0
• github.com/anujc25/tablewriter: v0.0.1
• github.com/r3labs/sse/v2: v2.10.0
• gopkg.in/cenkalti/backoff.v1: v1.1.0

Changed

• github.com/vmware-tanzu/tanzu-plugin-runtime: v1.3.0 → v1.4.1

Removed

• github.com/juju/fslock: 4d5c94c

New Contributors

• @warango4 made their first contribution in #705
• @mshipkovenski made their first contribution in #784

Full Changelog: v1.3.0...v1.4.0

v1.4.0-rc.0

Tanzu CLI Installation Instructions

If you are installing Tanzu CLI using the artifacts published as part of this release, please follow the
instructions.

Changes by Kind

✨ Features

• Add official support for the asdf package manager (MacOS and Linux) (#787, @marckhouzam)
• Support entry-specific active context type check in command mapping (#783, @vuil)

🐛 Bug Fixes

• Respect command mapping for the help command for plugins (#777, @marckhouzam)
• Show the description of the latest (instead of oldest) version of a plugin in the tanzu plugin search output. (#769, @marckhouzam)

♻️ Deprecations

• Deprecate the plugin invocation form tanzu kubernetes <plugin> in favour of the shorter and more consistent tanzu <plugin> (#781, @marckhouzam)
• Hide the tanzu init command which is no longer performing any actual initialization. (#773, @marckhouzam)

📄 Documentation

• Document details about ARM64 support. (#776, @marckhouzam)
• Update packages.vmware.com to packages-prod.broadcom.com (#780, @marckhouzam)

Dependencies

Added

• github.com/alexflint/go-filemutex: v1.3.0
• github.com/anujc25/tablewriter: v0.0.1
• github.com/r3labs/sse/v2: v2.10.0
• gopkg.in/cenkalti/backoff.v1: v1.1.0

Changed

• github.com/vmware-tanzu/tanzu-plugin-runtime: v1.3.0 → v1.4.0

Removed

Nothing has changed.

New Contributors

• @warango4 made their first contribution in #705
• @mshipkovenski made their first contribution in #784

Full Changelog: v1.3.0...v1.4.0-rc.0