From 57d47716e795d985d51b6e3f34a223cde7840335 Mon Sep 17 00:00:00 2001 From: Anita Flegg Date: Thu, 19 Oct 2023 07:12:08 -0700 Subject: [PATCH 01/19] update Notes format to improve appearance on CF docs --- getting-started.html.md.erb | 6 +++--- use-cli-plugins.html.md.erb | 2 +- v7.html.md.erb | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/getting-started.html.md.erb b/getting-started.html.md.erb index 6531b37..c37b7f8 100644 --- a/getting-started.html.md.erb +++ b/getting-started.html.md.erb @@ -261,7 +261,7 @@ OK

-Important +Important If you are not an admin, you see this message when you try to run these commands: error code: 10003, message: You are not authorized to perform the requested action

@@ -312,7 +312,7 @@ flag. For more information about the `-f` flag, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/push.html).

-Note +Note When you provide an app name at the command line, the cf push command uses that app name regardless of whether there is a different app name in the manifest. If the manifest configures multiple apps, you can push a single app by providing thenname at the command line; the cf CLI does not push the others. Use these behaviors for testing.

@@ -354,7 +354,7 @@ start command: bundle exec rackup config.ru -p $PORT -o 0.0.0.0

- Important +Important To avoid security exposure, verify that you migrate your apps and custom buildpacks to use the cflinuxfs4 stack based on Ubuntu 22.04 LTS (Jammy Jellyfish). The cflinuxfs3 stack is based on Ubuntu 18.04 (Bionic Beaver), which reaches end of standard support in April 2023.

diff --git a/use-cli-plugins.html.md.erb b/use-cli-plugins.html.md.erb index 3911481..fea75c8 100644 --- a/use-cli-plugins.html.md.erb +++ b/use-cli-plugins.html.md.erb @@ -9,7 +9,7 @@ The Cloud Foundry CLI (cf CLI) includes plug-in capability. The plug-in allows y You can install and use the plug-in that Cloud Foundry developers and third-party developers create. For a current list of community-supported plug-ins, see the [Cloud Foundry Community CLI Plug-in page](https://plugins.cloudfoundry.org). For information about submitting your own plug-in, see the [Cloud Foundry CLI Plugin Repository (CLIPR)](https://github.com/cloudfoundry-incubator/cli-plugin-repo) repository on GitHub.

-Important +Important Plug-ins are not vetted, including for security or function. Use plug-ins at your own risk.

The cf CLI identifies a plug-in by binary filename, its developer defined plug-in name, and the commands that the plug-in provides. Use the binary filename only to install a plug-in. You use the plug-in name or a command for any other action. diff --git a/v7.html.md.erb b/v7.html.md.erb index 1402e8d..a109104 100644 --- a/v7.html.md.erb +++ b/v7.html.md.erb @@ -73,7 +73,7 @@ Some of these changes are: * Single-quote resource names appear in error cases.

-Caution +Caution If the services attribute is declared at the top-level of the manifest.yml file, cf CLI v6 generates a warning, but in cf CLI v7, there is no warning and the app is still pushed.

### Exit codes From 716d8bd55df3af218ff85f8337849530c543be57 Mon Sep 17 00:00:00 2001 From: bobbygeeze Date: Fri, 27 Oct 2023 12:38:32 -0400 Subject: [PATCH 02/19] Table format edits --- getting-started.html.md.erb | 2 +- v8.html.md.erb | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/getting-started.html.md.erb b/getting-started.html.md.erb index c37b7f8..4a3fe62 100644 --- a/getting-started.html.md.erb +++ b/getting-started.html.md.erb @@ -292,7 +292,7 @@ To push an app: cf login ``` -1. Navigate to the directory of the app. +1. Go to the directory of the app. 1. Push a new app or push changes to an app by running: diff --git a/v8.html.md.erb b/v8.html.md.erb index b4246b4..3370ad3 100644 --- a/v8.html.md.erb +++ b/v8.html.md.erb @@ -68,7 +68,7 @@ Some of these changes are: ### Table of differences -The table below summarizes how commands differ between cf CLI v7 and cf CLI v8. +The following table summarizes how commands differ between cf CLI v7 and cf CLI v8. From 7fb205b0d26111d6a30914a1d05abfbff01c9ef1 Mon Sep 17 00:00:00 2001 From: blora1 <141881417+blora1@users.noreply.github.com> Date: Fri, 27 Oct 2023 10:46:14 -0400 Subject: [PATCH 03/19] Update table format. --- .gitignore | 27 +++++++++++---------------- v7.html.md.erb | 4 +++- v8.html.md.erb | 4 +++- 3 files changed, 17 insertions(+), 18 deletions(-) diff --git a/.gitignore b/.gitignore index 969d4ad..f2e804b 100644 --- a/.gitignore +++ b/.gitignore @@ -1,18 +1,13 @@ -# See http://help.github.com/ignore-files/ for more about ignoring files. -# -# If you find yourself ignoring temporary files generated by your text editor -# or operating system, you probably want to add a global ignore instead: -# git config --global core.excludesfile ~/.gitignore_global - -# Ignore bundler config +output +final_app .bundle - -# Ignore the build directory -build - -# Ignore Sass' cache -.sass-cache - -.idea +Gemfile.lock +final_app/* +cached_shas.yml +**/.sass-cache/* +bin vendor -.DS_Store \ No newline at end of file +[#]*[#] +.DS_Store +.ruby-version +.vscode/ \ No newline at end of file diff --git a/v7.html.md.erb b/v7.html.md.erb index a109104..88a021f 100644 --- a/v7.html.md.erb +++ b/v7.html.md.erb @@ -88,11 +88,13 @@ cf CLI v7 attempts to consistently apply the principles of idempotency across al The following table summarizes how commands differ between cf CLI v7 and cf CLI v6. -
+
+ +
Command Changes
cf add-network-policy diff --git a/v8.html.md.erb b/v8.html.md.erb index 3370ad3..19afb4d 100644 --- a/v8.html.md.erb +++ b/v8.html.md.erb @@ -70,11 +70,13 @@ Some of these changes are: The following table summarizes how commands differ between cf CLI v7 and cf CLI v8. - +
+ + diff --git a/v8.html.md.erb b/v8.html.md.erb index 19afb4d..fe3b11f 100644 --- a/v8.html.md.erb +++ b/v8.html.md.erb @@ -3,13 +3,14 @@ title: Upgrading to cf CLI v8 owner: CLI --- -You can use Cloud Foundry Command Line Interface (cf CLI) v8 to interact with Cloud Foundry API (CAPI) V3. This topic describes the major changes between cf CLI v7 and cf CLI v8. +You can use Cloud Foundry Command Line Interface (cf CLI) v8 to interact with Cloud Foundry API (CAPI) V3. This topic describes the major changes between cf CLI v7 +and cf CLI v8. The cf CLI development team aims to provide: * A seamless upgrade experience from cf CLI v7. Changes are minimal. Where there are changes, the team has incorporated feedback from the community to simplify the cf CLI user experience. -* Details about breaking potential breaking changes and alternative workflows for scripting environments. +* Details about potential breaking changes and alternative workflows for scripting environments. To understand the differences between specific commands, see [Command differences](#differences) below. @@ -30,7 +31,7 @@ To install cf CLI v8, see the [README](https://github.com/cloudfoundry/cli#downl It includes instructions for downloading the latest CAPI release candidate, which is what the cf CLI v8 beta is tested against. In cf CLI v8, Golang has been updated from v1.13 to v1.16. -If you target a foundation that does not have a SAN, you might encounter errors because the common name field is deprecated in Golang v1.15 and later. +When targeting a foundation that does not have a SAN, you might encounter errors because the common name field is deprecated in Golang v1.15 and later. For more information, see [X.509 CommonName deprecation](https://golang.org/doc/go1.15#commonname) in the Golang v1.15 release notes. ### Prerequisites @@ -63,7 +64,7 @@ Some of these changes are: * Style changes, including changes in the order or wording of the output. * cf CLI v8 uses CAPI V3 to make requests related to services. CAPI V3 creates asynchronous jobs. If you want to continue to create jobs synchronously, use the new `--wait` flag. -* JSON response changes such as additional elements or nesting. +* JSON response changes such as additional elements or nesting, which may impact parsing in existing scripts. ### Table of differences From 3bbd93b7e030f1f0c815491228493735d41fec9b Mon Sep 17 00:00:00 2001 From: Paul Spinrad Date: Tue, 22 Oct 2024 15:04:53 -0700 Subject: [PATCH 16/19] Merge pull request #89 from tcdowney/refer-to-help-flag Refer to --help flag instead of reference docs --- getting-started.html.md.erb | 49 ++++++++++++++++--------------------- use-cli-plugins.html.md.erb | 12 ++++----- 2 files changed, 27 insertions(+), 34 deletions(-) diff --git a/getting-started.html.md.erb b/getting-started.html.md.erb index 9a51b7c..60164c4 100644 --- a/getting-started.html.md.erb +++ b/getting-started.html.md.erb @@ -56,7 +56,7 @@ Org: example-org Space: development -Alternatively, you can write a script to log in and set your target using the non-interactive [cf api](http://cli.cloudfoundry.org/en-US/cf/api.html), [cf auth](http://cli.cloudfoundry.org/en-US/cf/auth.html), and [cf target](http://cli.cloudfoundry.org/en-US/cf/target.html) commands. See [UAAC](https://github.com/cloudfoundry/cf-uaac/blob/master/README.md) for setting up `client_id` and `client_secret`. +Alternatively, you can write a script to log in and set your target using the non-interactive `cf api`, `cf auth`, and `cf target` commands. See [UAAC](https://github.com/cloudfoundry/cf-uaac/blob/master/README.md) for setting up `client_id` and `client_secret`. ## Log in with the API @@ -72,7 +72,7 @@ To write a script to log in: Where `API-URL` is your API endpoint, <%= vars.api_endpoint %>.

- For more information about the `cf api` command, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/api.html). + For more information about the `cf api` command, use `cf api --help`. 1. Authenticate by running: @@ -85,7 +85,7 @@ To write a script to log in:
  • PASSWORD is your password. <%= vars.company_name %> discourages using the -p option, because it records your password in your shell history.
    • - For more information about the `cf auth` command, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/auth.html). + For more information about the `cf auth` command, use `cf auth --help`. 1. Target your org or space by running: @@ -98,7 +98,7 @@ To write a script to log in:
  • SPACE is the space you want to target.
    • - For more information about the `cf target` command, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/target.html). + For more information about the `cf target` command, use `cf target --help`. After you log in, the cf CLI saves a `config.json` file that contains your API endpoint, org, space values, and access token. If you change these settings, the `config.json` file is updated accordingly. @@ -123,7 +123,7 @@ The cf CLI supports these languages: * Portuguese (Brazil): `pt-BR` * Spanish: `es-ES` -For more information about the `cf config --locale` command, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/config.html). +For more information about the `cf config --locale` command, use `cf config --help`.

    Localizing the cf CLI affects only messages that the cf CLI generates.

    @@ -225,21 +225,21 @@ To list all users in an org or a space: louie@example.com -For more information about the `cf org-users` command, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/org-users.html). For -more information about the `cf space-users` command, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/space-users.html). +For more information about the `cf org-users` command, use `cf org-users --help`. For +more information about the `cf space-users` command, use `cf space-users --help`. ### Manage roles You use the commands listed below to manage roles in the cf CLI. These commands require admin permissions and take `username`, `org` or `space`, and `role` as arguments: -* `cf set-org-role`
    For more information, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/set-org-role.html). +* `cf set-org-role`
    For more information, use `cf set-org-role --help`. -* `cf unset-org-role`
    For more information, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/unset-org-role.html). +* `cf unset-org-role`
    For more information, use `cf unset-org-role --help`. -* `cf set-space-role`
    For more information, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/set-space-role.html). +* `cf set-space-role`
    For more information, use `cf set-space-role --help`. -* `cf unset-space-role`
    For more information, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/unset-space-role.html). +* `cf unset-space-role`
    For more information, use `cf unset-space-role --help`. The available roles are: @@ -280,7 +280,7 @@ To resolve this ambiguity, you can construct a `curl` command that uses the API These sections describe how to use the `cf push` command to push a new app or sync changes to an existing app. -For more information about the `cf push` command, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/push.html). +For more information about the `cf push` command, use `cf push --help`. ### Push a new app or push changes to an app @@ -309,7 +309,7 @@ of instances. You can use a manifest file rather than adding flags to the `cf pu `cf push` locates the `manifest.yml` file in the current working directory by default. Alternatively, you can provide a path to the manifest with the `-f` flag. -For more information about the `-f` flag, see the [Cloud Foundry CLI Reference Guide](http://cli.cloudfoundry.org/en-US/cf/push.html). +For more information about the `-f` flag, see the `cf push --help` output.

    Note @@ -395,8 +395,7 @@ These sections describe how to create or update a service instance. ### Create a service instance To create a new service instance, use the `cf create-user-provided-service` or `cf cups` commands. For more information about the -`cf create-user-provided-service` and `cf cups` commands, see the [Cloud Foundry CLI Reference -Guide](http://cli.cloudfoundry.org/en-US/cf/create-user-provided-service.html). +`cf create-user-provided-service` and `cf cups` commands, use `cf create-user-provided-service --help`. To create or update a user-provided service instance, you must supply basic parameters. For example, a database service might require a username, password, host, port, and database name. @@ -485,24 +484,19 @@ To create a service instance that sends data to a third party: After you create a user-provided service instance, you can: -* Bind the service to an app with `cf bind-service`. For more information, see the [Cloud Foundry CLI Reference -Guide](http://cli.cloudfoundry.org/en-US/cf/bind-service.html). +* Bind the service to an app with `cf bind-service`. For more information, use `cf bind-service --help`. -* Unbind the service with `cf unbind-service`. For more information, see the [Cloud Foundry CLI Reference -Guide](http://cli.cloudfoundry.org/en-US/cf/unbind-service.html). +* Unbind the service with `cf unbind-service`. For more information, use `cf unbind-service --help`. -* Rename the service with `cf rename-service`. For more information, see the [Cloud Foundry CLI Reference -Guide](http://cli.cloudfoundry.org/en-US/cf/rename-service.html). +* Rename the service with `cf rename-service`. For more information, use `cf rename-service --help`. -* Delete the service with `cf delete-service`. For more information, see the [Cloud Foundry CLI Reference -Guide](http://cli.cloudfoundry.org/en-US/cf/delete-service.html). +* Delete the service with `cf delete-service`. For more information, use `cf delete-service --help`. ### Update a service instance To update one or more of the parameters for an existing user-provided service instance, use `cf update-user-provided-service` or `cf uups`. -For more information about the `cf update-user-provided-service` and `cf uups` commands, see the [Cloud Foundry CLI Reference -Guide](http://cli.cloudfoundry.org/en-US/cf/update-user-provided-service.html). +For more information about the `cf update-user-provided-service` and `cf uups` commands, use `cf create-user-provided-service --help`.

    The cf uups command does not update any parameter values that you do not supply.

    @@ -536,10 +530,9 @@ If the command succeeds, the exit code is `0`. ## View CLI help output -The `cf help` command lists the cf CLI commands and a brief description of each. For more information, see the [Cloud Foundry CLI Reference -Guide](http://cli.cloudfoundry.org/en-US/cf/help.html). +The `cf help` command lists the cf CLI commands and a brief description of each.. -To list detailed help for any cf CLI command, add the `-h` flag to the command. +To list detailed help for any cf CLI command, add the `--help` or `-h` flag to the command. The example below shows detailed help output for the `cf delete` command: diff --git a/use-cli-plugins.html.md.erb b/use-cli-plugins.html.md.erb index 693bdea..382d815 100644 --- a/use-cli-plugins.html.md.erb +++ b/use-cli-plugins.html.md.erb @@ -46,7 +46,7 @@ To install a plug-in:

    The cf CLI prohibits you from implementing any plug-in that uses a native cf CLI command name or alias. For example, if you attempt to install a third-party plugin that includes the cf push command, the cf CLI halts the installation.

    -For more information, see [install-plugin](http://cli.cloudfoundry.org/en-US/cf/install-plugin.html) in the _Cloud Foundry CLI Reference Guide_. +For more information, use `cf install-plugin --help`. ## Managing plug-ins and running plug-in commands @@ -87,7 +87,7 @@ To check all registered plug-in repositories for newer versions of currently ins Use 'cf install-plugin' to update a plugin to the latest version. -For more information about the `cf plugins` command, see [cf plugins](http://cli.cloudfoundry.org/en-US/cf/plugins.html) in the _Cloud Foundry CLI Reference Guide_. +For more information about the `cf plugins` command, use `cf plugins --help`. ## Uninstalling a plug-in @@ -109,7 +109,7 @@ To uninstall a plug-in: You must use the name of the plug-in, not the binary filename, to uninstall it. -For more information, see [uninstall-plugin](http://cli.cloudfoundry.org/en-US/cf/uninstall-plugin.html) in the _Cloud Foundry CLI Reference Guide_. +For more information, use `cf uninstall-plugin --help`. ## Adding a plug-in repository @@ -122,7 +122,7 @@ To add a plug-in repository: ``` Where `REPOSITORY-NAME-URL` is the URL of the plug-in repository that you want to add. -For more information, see [add-plugin-repo](http://cli.cloudfoundry.org/en-US/cf/add-plugin-repo.html) in the _Cloud Foundry CLI Reference Guide_. +For more information, use `cf add-plugin-repo --help`. ## Viewing available plug-in repositories @@ -135,7 +135,7 @@ To view your available plug-in repositories: cf list-plugin-repos ``` -For more information, see [list-plugin-repos](http://cli.cloudfoundry.org/en-US/cf/list-plugin-repos.html) in the _Cloud Foundry CLI Reference Guide_. +For more information, use `cf list-plugin-repos --help`. ## Listing all plug-ins by repository @@ -148,7 +148,7 @@ To show all plug-ins from all available repositories: cf repo-plugins ``` -For more information, see [repo-plugins](http://cli.cloudfoundry.org/en-US/cf/repo-plugins.html) in the _Cloud Foundry CLI Reference Guide_. +For more information, use `cf repo-plugins --help`. ## Troubleshooting From 2edd70a68f938e102b858878bbf1207e0888d26f Mon Sep 17 00:00:00 2001 From: anita-flegg Date: Fri, 1 Nov 2024 12:12:22 -0700 Subject: [PATCH 17/19] remove extra Note class (cherry picked from commit e21a3abe337c1799f4b32bf5c2dbfef44eee8a0d) --- getting-started.html.md.erb | 3 --- install-go-cli.html.md.erb | 1 - use-cli-plugins.html.md.erb | 1 - v7.html.md.erb | 1 - 4 files changed, 6 deletions(-) diff --git a/getting-started.html.md.erb b/getting-started.html.md.erb index 60164c4..6906b45 100644 --- a/getting-started.html.md.erb +++ b/getting-started.html.md.erb @@ -261,7 +261,6 @@ OK

    -Important If you are not an admin, you see this message when you try to run these commands: error code: 10003, message: You are not authorized to perform the requested action

    @@ -312,7 +311,6 @@ flag. For more information about the `-f` flag, see the `cf push --help` output.

    -Note When you provide an app name at the command line, the cf push command uses that app name instead of any app name provided in the manifest. If the manifest configures multiple apps, you can push a single app by providing thenname at the command line; the cf CLI does not push the others. Use these behaviors for testing.

    @@ -354,7 +352,6 @@ start command: bundle exec rackup config.ru -p $PORT -o 0.0.0.0

    -Important To avoid security exposure, verify that you migrate your apps and custom buildpacks to use the cflinuxfs4 stack based on Ubuntu 22.04 LTS (Jammy Jellyfish). The cflinuxfs3 stack is based on Ubuntu 18.04 (Bionic Beaver), which reaches end of standard support in April 2023.

    diff --git a/install-go-cli.html.md.erb b/install-go-cli.html.md.erb index 7083bcf..34f4bf9 100644 --- a/install-go-cli.html.md.erb +++ b/install-go-cli.html.md.erb @@ -100,7 +100,6 @@ You can install the cf CLI using a compressed binary on Windows, macOS X, and Li This method can be a more secure option compared to installing from a repository, especially in environments where security is a primary concern.

    -Note As of cf CLI 8.4.0 and cf CLI 7.5.0, the Apple ARM architecture is now supported for installation of cf CLI. This is possible on newer MACs that use M1 and M2 processors. For systems running the M1 processor, cf CLI can now be installed without use of an emulator.

    diff --git a/use-cli-plugins.html.md.erb b/use-cli-plugins.html.md.erb index 382d815..4b54871 100644 --- a/use-cli-plugins.html.md.erb +++ b/use-cli-plugins.html.md.erb @@ -9,7 +9,6 @@ The Cloud Foundry CLI (cf CLI) includes plug-in capability. Plug-ins allow you t You can install and use the plug-in that Cloud Foundry developers and third-party developers create. For a current list of community-supported plug-ins, see the [Cloud Foundry Community CLI Plug-in page](https://plugins.cloudfoundry.org). For information about submitting your own plug-in, see the [Cloud Foundry CLI Plugin Repository (CLIPR)](https://github.com/cloudfoundry-incubator/cli-plugin-repo) repository on GitHub.

    -Important Plug-ins are not vetted for security or function. Use plug-ins at your own risk.

    The cf CLI identifies a plug-in by binary filename, its developer defined plug-in name, and the commands that the plug-in provides. Use the binary filename only to install a plug-in. You use the plug-in name or a command for any other action. diff --git a/v7.html.md.erb b/v7.html.md.erb index 5c10753..f8651d3 100644 --- a/v7.html.md.erb +++ b/v7.html.md.erb @@ -75,7 +75,6 @@ Some of these changes are: * Single-quote resource names appear in error cases.

    -Caution If the services attribute is declared at the top-level of the manifest.yml file, cf CLI v6 generates a warning, but in cf CLI v7, there is no warning and the app is still pushed.

    ### Exit codes From 4d6fca4b40aa4ba5236da81817b8a0b663d2c20e Mon Sep 17 00:00:00 2001 From: Paul Spinrad Date: Wed, 6 Nov 2024 13:57:06 -0800 Subject: [PATCH 18/19] Merge pull request #93 from gururajsh/update-v8-docs Fix v8 docs --- v8.html.md.erb | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/v8.html.md.erb b/v8.html.md.erb index fe3b11f..25a0f38 100644 --- a/v8.html.md.erb +++ b/v8.html.md.erb @@ -133,7 +133,7 @@ The following table summarizes how commands differ between cf CLI v7 and cf CLI     @@ -222,7 +222,7 @@ The following table summarizes how commands differ between cf CLI v7 and cf CLI From bbd9ef3eaf442eed7a9d7baed8353231250b8b53 Mon Sep 17 00:00:00 2001 From: Anita Flegg Date: Wed, 28 May 2025 07:03:04 -0700 Subject: [PATCH 19/19] add branch table to commercial branches --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 2aedc4e..d734560 100644 --- a/README.md +++ b/README.md @@ -15,3 +15,14 @@ repo for the complete list of open source documentation repositories, as well as information about the publishing process. +This branch is published through the [docs-book-application-service](https://github.gwd.broadcom.net/TNZ/docs-book-application-service) repository. + +## Branch map + +| Branch | TPCF version | Doc Link | +|---------|---------------|---------------| +| tcf-102 | TPCF 10.2 | [TPCF v10.2 staging](https://author-techdocs2-prod.adobecqms.net/content/broadcom/techdocs/us/en/vmware-tanzu/platform/tanzu-platform-for-cloud-foundry/10-2/tpcf/concepts-overview.html) | +| tcf-10 | TPCF 10.0 | [TPCF v10.0](https://techdocs.broadcom.com/us/en/vmware-tanzu/platform/tanzu-platform-for-cloud-foundry/10-0/tpcf/concepts-overview.html) | +| TAS-6.0 | TAS 6.0 | [TAS v6.0](https://techdocs.broadcom.com/us/en/vmware-tanzu/platform/tanzu-platform-for-cloud-foundry/6-0/tpcf/concepts-overview.html) | +| TAS-5.0 | TAS 5.0 | archived PDF | +| 22.0 | TAS v4.0 | [TAS v4.0](https://techdocs.broadcom.com/us/en/vmware-tanzu/platform/tanzu-platform-for-cloud-foundry/4-0/tpcf/concepts-overview.html) |
    Command Changes
    cf bind-service From f77dbc2ccdf4c098079c6e5dfa6db9f23ad10ecf Mon Sep 17 00:00:00 2001 From: Anita Flegg Date: Wed, 15 Nov 2023 10:29:14 -0800 Subject: [PATCH 04/19] update formatting around graphics (cherry picked from commit dbb699d34c3c88228af15c0eb608dbcb19d07a96) --- http-proxy.html.md.erb | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/http-proxy.html.md.erb b/http-proxy.html.md.erb index c407164..70c2687 100644 --- a/http-proxy.html.md.erb +++ b/http-proxy.html.md.erb @@ -69,19 +69,23 @@ To set the `https_proxy` environment variable in Windows: 1. In the left pane of the **System** window, click **Advanced system settings**. + ![alt-text="An arrow points to'Advanced system settings', which is the last item in the Control Panel Home."](./images/adv-settings.png) 2. In the **System Properties** window: 1. Select **Advanced**. 2. Click **Environment Variables**. + ![alt-text="An arrow points to'Advanced system settings', which is the last item in the Control Panel Home."](./images/env-var.png) 3. Under **User variables**, click **New**. + ![alt-text="An arrow points to the 'New' button, which is the first button under the user variables table"](./images/new.png) 4. For **Variable name**, enter `https_proxy`. 5. For **Variable value**, enter your proxy server information. + ![alt-text="Variable name text field has 'https_proxy' entered. Variable value text field has 'http://my.proxyserver.com:8080 entered."](./images/proxy.png) 6. Click **OK**. From d4f097208ec104bf4dd691e4979c1f736d1e2b90 Mon Sep 17 00:00:00 2001 From: Anita Flegg Date: Wed, 24 Jan 2024 14:45:48 -0800 Subject: [PATCH 05/19] [#183290231] added note about new support for Apple ARM (cherry picked from commit 93500047d39cd40c0407eb4c5cf1be57d3cf4a0f) --- install-go-cli.html.md.erb | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/install-go-cli.html.md.erb b/install-go-cli.html.md.erb index b664139..f9481fc 100644 --- a/install-go-cli.html.md.erb +++ b/install-go-cli.html.md.erb @@ -97,6 +97,11 @@ To install the cf CLI for Mac OS X using Homebrew: You can install the cf CLI using a compressed binary on Windows, Mac OS X, and Linux operating systems. +

    +Note +As of CF CLI 8.4.0 and CF CLI 7.5.0, the Apple ARM architecture is now supported for installation of CF CLI. This is possible on newer MACs that use M1 and M2 processors. For systems running the M1 processor, CF CLI can now be installed without use of an emulator. +

    + For more information about downloading and installing a compressed binary for **cf CLI v7**, see [Installers and compressed binaries](https://github.com/cloudfoundry/cli/blob/master/doc/installation-instructions/installation-instructions-v7.md#installers-and-compressed-binaries). For more information about downloading and installing a compressed binary for **cf CLI v8**, see [Installers and compressed binaries](https://github.com/cloudfoundry/cli/wiki/V8-CLI-Installation-Guide#installers-and-compressed-binaries). From f1fff5cb373eb49892a54860fbcf5dc1cf840c2e Mon Sep 17 00:00:00 2001 From: Anita Flegg Date: Thu, 25 Jan 2024 06:17:20 -0800 Subject: [PATCH 06/19] [#182440606] add mention about security difference when installing binary (cherry picked from commit d7fe7e9a37e2e51c51ab1195ce3153c411049fb3) --- install-go-cli.html.md.erb | 1 + 1 file changed, 1 insertion(+) diff --git a/install-go-cli.html.md.erb b/install-go-cli.html.md.erb index f9481fc..26350c8 100644 --- a/install-go-cli.html.md.erb +++ b/install-go-cli.html.md.erb @@ -96,6 +96,7 @@ To install the cf CLI for Mac OS X using Homebrew: ## Install the cf CLI using a compressed binary You can install the cf CLI using a compressed binary on Windows, Mac OS X, and Linux operating systems. +In cases where security concerns are paramount, using this method can be a better option than installing from a repository.

    Note From 0109c9e6153450ed9c31165250651b7cc6a9640d Mon Sep 17 00:00:00 2001 From: Anita Flegg Date: Tue, 6 Feb 2024 06:41:48 -0800 Subject: [PATCH 07/19] fix formatting issues (cherry picked from commit 941d090434cdbf2f1cb5e55f52d7cfd8a3b6f959) --- install-go-cli.html.md.erb | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/install-go-cli.html.md.erb b/install-go-cli.html.md.erb index 26350c8..c994229 100644 --- a/install-go-cli.html.md.erb +++ b/install-go-cli.html.md.erb @@ -27,7 +27,7 @@ To uninstall the gem: 1. Verify that your Ruby environment manager uninstalled the gem by closing and reopening your terminal. -## Install the cf CLI Using a package manager +## Install the cf CLI using a package manager These sections describe how to install the cf CLI using a package manager. You can install the cf CLI using a package manager on Mac OS X and Linux operating systems. @@ -99,13 +99,11 @@ You can install the cf CLI using a compressed binary on Windows, Mac OS X, and L In cases where security concerns are paramount, using this method can be a better option than installing from a repository.

    -Note +Note As of CF CLI 8.4.0 and CF CLI 7.5.0, the Apple ARM architecture is now supported for installation of CF CLI. This is possible on newer MACs that use M1 and M2 processors. For systems running the M1 processor, CF CLI can now be installed without use of an emulator.

    -For more information about downloading and installing a compressed binary for **cf CLI v7**, see [Installers and compressed binaries](https://github.com/cloudfoundry/cli/blob/master/doc/installation-instructions/installation-instructions-v7.md#installers-and-compressed-binaries). - -For more information about downloading and installing a compressed binary for **cf CLI v8**, see [Installers and compressed binaries](https://github.com/cloudfoundry/cli/wiki/V8-CLI-Installation-Guide#installers-and-compressed-binaries). +For more information about downloading and installing a compressed binary for cf CLI v7 or cf CLI v8, see [Installers and compressed binaries](https://github.com/cloudfoundry/cli/wiki/V8-CLI-Installation-Guide#installers-and-compressed-binaries). ## Verify installation From 73824b22b7e90ab6f3154da05e6ccfb4a440ac79 Mon Sep 17 00:00:00 2001 From: Anita Flegg Date: Fri, 15 Mar 2024 14:16:20 -0700 Subject: [PATCH 08/19] update alt-text syntax (cherry picked from commit 4f31009ee495fa7fba040debcfda990d43554b4d) --- http-proxy.html.md.erb | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/http-proxy.html.md.erb b/http-proxy.html.md.erb index 70c2687..b81fdd6 100644 --- a/http-proxy.html.md.erb +++ b/http-proxy.html.md.erb @@ -65,27 +65,27 @@ To set the `https_proxy` environment variable in Windows: 1. Right-click **Computer** and select **Properties**. - ![alt-text="An arrow points to 'Properties' as the last item of the right-click menu."](./images/properties.png) + ![An arrow points to 'Properties' as the last item of the right-click menu.](./images/properties.png) 1. In the left pane of the **System** window, click **Advanced system settings**. - ![alt-text="An arrow points to'Advanced system settings', which is the last item in the Control Panel Home."](./images/adv-settings.png) + ![An arrow points to'Advanced system settings', which is the last item in the Control Panel Home.](./images/adv-settings.png) 2. In the **System Properties** window: 1. Select **Advanced**. 2. Click **Environment Variables**. - ![alt-text="An arrow points to'Advanced system settings', which is the last item in the Control Panel Home."](./images/env-var.png) + ![An arrow points to'Advanced system settings', which is the last item in the Control Panel Home.](./images/env-var.png) 3. Under **User variables**, click **New**. - ![alt-text="An arrow points to the 'New' button, which is the first button under the user variables table"](./images/new.png) + ![An arrow points to the 'New' button, which is the first button under the user variables table](./images/new.png) 4. For **Variable name**, enter `https_proxy`. 5. For **Variable value**, enter your proxy server information. - ![alt-text="Variable name text field has 'https_proxy' entered. Variable value text field has 'http://my.proxyserver.com:8080 entered."](./images/proxy.png) + ![Variable name text field has 'https_proxy' entered. Variable value text field has 'http://my.proxyserver.com:8080 entered.](./images/proxy.png) 6. Click **OK**. From 4bd144295af70472e874371ee16db1da60aa4d33 Mon Sep 17 00:00:00 2001 From: Paul Spinrad Date: Thu, 23 May 2024 11:52:18 -0700 Subject: [PATCH 09/19] #187613290 one CF CLI index page --- index.html.md.erb | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/index.html.md.erb b/index.html.md.erb index fb58b0f..61bd276 100644 --- a/index.html.md.erb +++ b/index.html.md.erb @@ -7,9 +7,11 @@ These topics explain the Cloud Foundry Command Line Interface (cf CLI), a tool u ## Table of Contents -* [Installing the cf CLI](install-go-cli.html). -* [Getting Started with the cf CLI](getting-started.html). -* [Using the cf CLI with an HTTP proxy server](http-proxy.html). -* [Using the cf CLI with a self-signed certificate](self-signed.html). -* [Using cf CLI plug-ins](use-cli-plugins.html). -* [Developing cf CLI plug-ins](develop-cli-plugins.html). +* [Installing the cf CLI](install-go-cli.html) +* [Upgrading to cf CLI v7](v7.html) +* [Upgrading to cf CLI v8](v8.html) +* [Getting started with the cf CLI](getting-started.html) +* [Using the cf CLI with a proxy server](http-proxy.html) +* [Using the cf CLI with a self-signed certificate](self-signed.html) +* [Using cf CLI plug-ins](use-cli-plugins.html) +* [Developing cf CLI plug-ins](develop-cli-plugins.html) From 98664fbe1aaf047cf68a33185f40df05ff2cfb5f Mon Sep 17 00:00:00 2001 From: Paul Spinrad Date: Thu, 23 May 2024 14:09:15 -0700 Subject: [PATCH 10/19] 187012696 change cf CLI v7 ref's to v7+ etc. --- develop-cli-plugins.html.md.erb | 2 +- http-proxy.html.md.erb | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/develop-cli-plugins.html.md.erb b/develop-cli-plugins.html.md.erb index 6e990ab..0847e73 100644 --- a/develop-cli-plugins.html.md.erb +++ b/develop-cli-plugins.html.md.erb @@ -9,7 +9,7 @@ You can create and install cf CLI plug-ins to provide custom commands. You can s ## Prerequisite -To use plug-ins, you must use cf CLI v7 or later. For information about downloading, installing, and uninstalling tcf CLI commands, see [Installing the Cloud Foundry Command Line Interface](install-go-cli.html). +To use plug-ins, you must use cf CLI v7+. For information about downloading, installing, and uninstalling tcf CLI commands, see [Installing the Cloud Foundry Command Line Interface](install-go-cli.html). ## Creating a plug-in diff --git a/http-proxy.html.md.erb b/http-proxy.html.md.erb index b81fdd6..f7eb66a 100644 --- a/http-proxy.html.md.erb +++ b/http-proxy.html.md.erb @@ -35,7 +35,7 @@ If the proxy server is a SOCKS5 proxy, you must specify the SOCKS5 protocol in t https_proxy=socks5://socks_proxy.example.com ``` -

    The cf ssh command for cf CLI v7 does not work through a SOCKS5 proxy.

    +The cf ssh command for cf CLI v7+ does not work through a SOCKS5 proxy. ## Set https_proxy in Mac OS or Linux From 21d9fd9cb508a289310ff449f3c3d507f66a19c5 Mon Sep 17 00:00:00 2001 From: Glenn Oppegard Date: Thu, 18 Jul 2024 11:50:29 -0600 Subject: [PATCH 11/19] Add CPU entitlement to `cf` examples --- getting-started.html.md.erb | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/getting-started.html.md.erb b/getting-started.html.md.erb index 4a3fe62..c57b2d9 100644 --- a/getting-started.html.md.erb +++ b/getting-started.html.md.erb @@ -338,7 +338,7 @@ Waiting for app awesome-app to start... name: awesome-app requested state: started routes: awesome-app.example.com -last uploaded: Fri 16 Sep 01:54:16 UTC 2022 +last uploaded: Wed 17 Jul 22:57:04 UTC 2024 stack: cflinuxfs3 buildpacks: name version detect output buildpack name @@ -349,8 +349,8 @@ sidecars: instances: 1/1 memory usage: 1024M start command: bundle exec rackup config.ru -p $PORT -o 0.0.0.0 - state since cpu memory disk logging details -#0 running 2022-09-16T01:54:29Z 0.0% 0 of 0 0 of 0 0/s of 0/s + state since cpu memory disk logging cpu entitlement details +#0 running 2024-07-17T22:57:22Z 0.3% 49.5M of 1G 130.2M of 1G 0B/s of 16K/s 2.4%

    From 656637e46c6a0a0bf7e0c78b4f7be2d03a955cad Mon Sep 17 00:00:00 2001 From: George Gelashvili Date: Fri, 19 Jul 2024 13:29:59 -0700 Subject: [PATCH 12/19] Update CAPI v2 docs links to new subdomain --- getting-started.html.md.erb | 2 +- v7.html.md.erb | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/getting-started.html.md.erb b/getting-started.html.md.erb index c57b2d9..c137fb1 100644 --- a/getting-started.html.md.erb +++ b/getting-started.html.md.erb @@ -273,7 +273,7 @@ either `cf set-org-role` or `cf unset-org-role` returns an error similar to the 

    The user exists in multiple origins. Specify an origin for the requested user from: ‘uaa’, ‘other’
    To resolve this ambiguity, you can construct a `curl` command that uses the API to perform the desired role management function. For an example, see the -[Cloud Foundry API documentation](http://apidocs.cloudfoundry.org/280/organizations/associate_auditor_with_the_organization_by_username.html). +[Cloud Foundry API documentation](https://v3-apidocs.cloudfoundry.org/version/3.169.0/index.html#create-a-role). ## Push an app diff --git a/v7.html.md.erb b/v7.html.md.erb index 88a021f..fe04681 100644 --- a/v7.html.md.erb +++ b/v7.html.md.erb @@ -14,7 +14,7 @@ The cf CLI development team aims to provide: To understand the differences between specific commands, see [Command Differences](#differences) below. -For more information about CAPI V3, see the [CAPI V3 documentation](https://v3-apidocs.cloudfoundry.org/index.html#introduction). For more information about CAPI V2, see the [CAPI V2 documentation](http://apidocs.cloudfoundry.org/). +For more information about CAPI V3, see the [CAPI V3 documentation](https://v3-apidocs.cloudfoundry.org/index.html#introduction). For more information about CAPI V2, see the [CAPI V2 documentation](http://v2-apidocs.cloudfoundry.org/). ## New workflows supported by cf CLI v7 From 9402c8ef21cc7b96b0a1aa59db375eb08a110872 Mon Sep 17 00:00:00 2001 From: Paul Spinrad Date: Tue, 17 Sep 2024 11:37:04 -0700 Subject: [PATCH 13/19] Merge pull request #90 from vchrisb/ubuntuinstall update ubuntu install steps --- install-go-cli.html.md.erb | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/install-go-cli.html.md.erb b/install-go-cli.html.md.erb index c994229..85bfe2a 100644 --- a/install-go-cli.html.md.erb +++ b/install-go-cli.html.md.erb @@ -39,8 +39,8 @@ To install the cf CLI on Debian and Ubuntu-based Linux distributions: 1. Add the Cloud Foundry Foundation public key and package repository to your system by running: - wget -q -O - https://packages.cloudfoundry.org/debian/cli.cloudfoundry.org.key | sudo apt-key add - - echo "deb https://packages.cloudfoundry.org/debian stable main" | sudo tee /etc/apt/sources.list.d/cloudfoundry-cli.list + sudo wget -q -O /usr/share/keyrings/cli.cloudfoundry.org.gpg https://packages.cloudfoundry.org/debian/cli.cloudfoundry.org.key + echo "deb [signed-by=/usr/share/keyrings/cli.cloudfoundry.org.key] https://packages.cloudfoundry.org/debian stable main" | sudo tee /etc/apt/sources.list.d/cloudfoundry-cli.list 1. Update your local package index by running: From 9c2b506de5e93402cb69d25cb24b2d7eefbae69b Mon Sep 17 00:00:00 2001 From: Paul Spinrad Date: Wed, 18 Sep 2024 11:36:35 -0700 Subject: [PATCH 14/19] Merge pull request #91 from vchrisb/ubuntuinstallfix fix ubuntu cli install steps --- install-go-cli.html.md.erb | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/install-go-cli.html.md.erb b/install-go-cli.html.md.erb index 85bfe2a..8db34a1 100644 --- a/install-go-cli.html.md.erb +++ b/install-go-cli.html.md.erb @@ -39,8 +39,8 @@ To install the cf CLI on Debian and Ubuntu-based Linux distributions: 1. Add the Cloud Foundry Foundation public key and package repository to your system by running: - sudo wget -q -O /usr/share/keyrings/cli.cloudfoundry.org.gpg https://packages.cloudfoundry.org/debian/cli.cloudfoundry.org.key - echo "deb [signed-by=/usr/share/keyrings/cli.cloudfoundry.org.key] https://packages.cloudfoundry.org/debian stable main" | sudo tee /etc/apt/sources.list.d/cloudfoundry-cli.list + wget -q -O - https://packages.cloudfoundry.org/debian/cli.cloudfoundry.org.key | sudo gpg --dearmor -o /usr/share/keyrings/cli.cloudfoundry.org.gpg + echo "deb [signed-by=/usr/share/keyrings/cli.cloudfoundry.org.gpg] https://packages.cloudfoundry.org/debian stable main" | sudo tee /etc/apt/sources.list.d/cloudfoundry-cli.list 1. Update your local package index by running: From d583bd4b39c54bfb5fdc3ac057c8a782c6736941 Mon Sep 17 00:00:00 2001 From: Paul Spinrad Date: Wed, 25 Sep 2024 14:13:19 -0700 Subject: [PATCH 15/19] Merge pull request #92 from animatedmax/master use product name before abbreviation, clarify wording, fix typos --- develop-cli-plugins.html.md.erb | 4 ++-- getting-started.html.md.erb | 10 ++++++---- http-proxy.html.md.erb | 23 +++++++++++++---------- install-go-cli.html.md.erb | 23 ++++++++++++----------- self-signed.html.md.erb | 10 +++++----- use-cli-plugins.html.md.erb | 14 +++++++------- v7.html.md.erb | 18 ++++++++++-------- v8.html.md.erb | 9 +++++---- 8 files changed, 60 insertions(+), 51 deletions(-) diff --git a/develop-cli-plugins.html.md.erb b/develop-cli-plugins.html.md.erb index 0847e73..c157100 100644 --- a/develop-cli-plugins.html.md.erb +++ b/develop-cli-plugins.html.md.erb @@ -4,12 +4,12 @@ owner: CLI --- -You can create and install cf CLI plug-ins to provide custom commands. You can submit and share these plug-ins to the [CF Community repository](https://plugins.cloudfoundry.org/). +You can create and install Cloud Foundry Command Line Interface (cf CLI) plug-ins to provide custom commands. You can submit and share these plug-ins to the [CF Community repository](https://plugins.cloudfoundry.org/). ## Prerequisite -To use plug-ins, you must use cf CLI v7+. For information about downloading, installing, and uninstalling tcf CLI commands, see [Installing the Cloud Foundry Command Line Interface](install-go-cli.html). +To use plug-ins, you must use cf CLI v7 or later. For information about downloading, installing, and uninstalling cf CLI commands, see [Installing the Cloud Foundry Command Line Interface](install-go-cli.html). ## Creating a plug-in diff --git a/getting-started.html.md.erb b/getting-started.html.md.erb index c137fb1..9a51b7c 100644 --- a/getting-started.html.md.erb +++ b/getting-started.html.md.erb @@ -4,7 +4,7 @@ owner: CLI --- -The cf CLI is the official command line client for Cloud Foundry. You can use the cf CLI to manage apps, service instances, orgs, spaces, and users in your environment. +The Cloud Foundry Command Line Interface (cf CLI) is the official command line client for Cloud Foundry. You can use the cf CLI to manage apps, service instances, orgs, spaces, and users in your environment. ## Prerequisite @@ -314,7 +314,7 @@ For more information about the `-f` flag, see the [Cloud Foundry CLI Reference G

    Note When you provide an app name at the command line, the cf push command uses that app -name regardless of whether there is a different app name in the manifest. If the manifest configures multiple apps, you can push a +name instead of any app name provided in the manifest. If the manifest configures multiple apps, you can push a single app by providing thenname at the command line; the cf CLI does not push the others. Use these behaviors for testing.

    ### Push an app with a buildpack @@ -361,7 +361,9 @@ based on Ubuntu 18.04 (Bionic Beaver), which reaches end of standard support in ### Map a route to an app -You can provide a hostname for your app when you push the app. If you do not provide a hostname, the `cf push` command routes your app to a URL of the form `APP-NAME.DOMAIN`, where `APP-NAME` is the name of your app and `DOMAIN` is your default domain. The route definition is included in the `manifest.yml` file. +You can provide a hostname for your app when you push the app. If you do not provide a hostname, the `cf push` command routes your app to a URL of the form +`APP-NAME.DOMAIN`, where `APP-NAME` is the name of your app and `DOMAIN` is the default domain configured in the Cloud Foundry environment. The route definition is +included in the `manifest.yml` file. For information about mapping a route to your app, see [Routes and domains](../devguide/deploy-apps/routes-domains.html). @@ -518,7 +520,7 @@ To view a cf CLI exit code: ``` 1. To check that the login was successful, run one of these commands, depending on your OS: - * For Mac OS, run: + * For macOS, run: ``` echo $? diff --git a/http-proxy.html.md.erb b/http-proxy.html.md.erb index f7eb66a..8100095 100644 --- a/http-proxy.html.md.erb +++ b/http-proxy.html.md.erb @@ -4,32 +4,35 @@ owner: CLI --- -If you have an HTTP or SOCKS5 proxy server on your network between a host running the cf CLI and your API endpoint, you must set `https_proxy` with the hostname or IP address of the proxy server. The `https_proxy` environment variable holds the hostname or IP address of your proxy server. +If you have an HTTP or SOCKS5 proxy server on your network between a host running the Cloud Foundry Command Line Interface (cf CLI) and your API endpoint, you must +set the `https_proxy` variable with the hostname or IP address of the proxy server. The `https_proxy` environment variable holds the hostname or IP address of the +proxy server. -The `https_proxy` is a standard environment variable. As with any environment variable, the specific steps you use to set it depends on your operating system. +The `https_proxy` variable is a standard environment variable. As with any environment variable, the specific steps used to set it depends on your operating +system. ## Format of https_proxy -The `https_proxy` variable is set with hostname or IP address of the proxy server in URL format, as in the following example: +The `https_proxy` variable is set with hostname or IP address of the proxy server in URL format, as shown in the following example: ``` https_proxy=http://proxy.example.com ``` -If the proxy server requires a username and password, you must include the credentials, as in the following example: +If the proxy server requires a username and password, you must include the credentials, as shown in the following example: ``` https_proxy=http://username:password@proxy.example.com ``` -If the proxy server uses a port other than 80, you must include the port number, as in the following example: +If the proxy server uses a port other than 80, you must include the port number, as shown in the following example: ``` https_proxy=http://username:password@proxy.example.com:8080 ``` -If the proxy server is a SOCKS5 proxy, you must specify the SOCKS5 protocol in the URL, as in the following example: +If the proxy server is a SOCKS5 proxy, you must specify the SOCKS5 protocol in the URL, as shown in the following example: ``` https_proxy=socks5://socks_proxy.example.com @@ -38,18 +41,18 @@ https_proxy=socks5://socks_proxy.example.com The cf ssh command for cf CLI v7+ does not work through a SOCKS5 proxy. -## Set https_proxy in Mac OS or Linux +## Set https_proxy in macOS or Linux -To set the `https_proxy` environment variable in Mac OS or Linux: +To set the `https_proxy` environment variable in macOS or Linux: -1. Use the command specific to your shell. For example, in bash, use the `export` command, as in the followingn example: +1. Use the command specific to your shell. For example, in bash, use the `export` command, as shown in the following example: ``` export https_proxy=http://my.proxyserver.com:8080 ``` 1. To make this change persistent, add the command to the appropriate profile file for the shell. For example, in bash, add a -line like the followingn example to your `.bash_profile` or `.bashrc` file: +line similar to the following example to your `.bash_profile` or `.bashrc` file: ``` https_proxy=http://username:password@hostname:port diff --git a/install-go-cli.html.md.erb b/install-go-cli.html.md.erb index 8db34a1..7083bcf 100644 --- a/install-go-cli.html.md.erb +++ b/install-go-cli.html.md.erb @@ -3,7 +3,8 @@ title: Installing the cf CLI owner: CLI --- -The cf CLI is the official command line client for Cloud Foundry. +The Cloud Foundry Command Line Interface (cf CLI) is the official command line client for Cloud Foundry. Use the cf CLI to interact with Cloud Foundry applications +and services. The following procedures describe how to install the cf CLI on your operating system. You can install the cf CLI with a package manager, an installer, or a compressed binary. @@ -16,7 +17,7 @@ There are currently two major versions of the cf CLI: v7 and v8. See [the README ## Prerequisites -If you previously used the cf CLI Ruby gem, you must uninstall the gem before installing the cf CLI. +If you have previously used the cf CLI Ruby gem, you must uninstall it before installing the cf CLI. To uninstall the gem: @@ -29,7 +30,7 @@ To uninstall the gem: ## Install the cf CLI using a package manager -These sections describe how to install the cf CLI using a package manager. You can install the cf CLI using a package manager on Mac OS X and Linux operating systems. +These sections describe how to install the cf CLI using a package manager. You can install the cf CLI using a package manager on macOS X and Linux operating systems. ### Linux installation @@ -71,11 +72,11 @@ To install the cf CLI on Enterprise Linux and Fedora RHEL6/CentOS6 and later dis This also downloads and adds the public key to your system. -### Mac OS X installation +### macOS X installation -You can install the cf CLI on Mac OS X operating systems using the Homebrew package manager. +You can install the cf CLI on macOS X operating systems using the Homebrew package manager. -To install the cf CLI for Mac OS X using Homebrew: +To install the cf CLI for macOS X using Homebrew: 1. Install Homebrew. For instructions, see [Install Homebrew](http://brew.sh/) on the Homebrew website. @@ -95,12 +96,12 @@ To install the cf CLI for Mac OS X using Homebrew: ## Install the cf CLI using a compressed binary -You can install the cf CLI using a compressed binary on Windows, Mac OS X, and Linux operating systems. -In cases where security concerns are paramount, using this method can be a better option than installing from a repository. +You can install the cf CLI using a compressed binary on Windows, macOS X, and Linux operating systems. +This method can be a more secure option compared to installing from a repository, especially in environments where security is a primary concern.

    Note -As of CF CLI 8.4.0 and CF CLI 7.5.0, the Apple ARM architecture is now supported for installation of CF CLI. This is possible on newer MACs that use M1 and M2 processors. For systems running the M1 processor, CF CLI can now be installed without use of an emulator. +As of cf CLI 8.4.0 and cf CLI 7.5.0, the Apple ARM architecture is now supported for installation of cf CLI. This is possible on newer MACs that use M1 and M2 processors. For systems running the M1 processor, cf CLI can now be installed without use of an emulator.

    For more information about downloading and installing a compressed binary for cf CLI v7 or cf CLI v8, see [Installers and compressed binaries](https://github.com/cloudfoundry/cli/wiki/V8-CLI-Installation-Guide#installers-and-compressed-binaries). @@ -109,7 +110,7 @@ For more information about downloading and installing a compressed binary for cf To verify the installation of the cf CLI: -1. Close and reopen the command prompt. Or, open a new tab in the command prompt. +1. Close and reopen the command prompt, or open a new tab in the command prompt terminal. 1. Run: @@ -130,7 +131,7 @@ If you installed the cf CLI with a package manager, follow the instructions spec If you installed the cf CLI with an installer, follow the procedure in this section that is specific to your operating system. -To uninstall the cf CLI on Mac OS X: +To uninstall the cf CLI on macOS X: 1. Delete the binary `/usr/local/bin/cf`. diff --git a/self-signed.html.md.erb b/self-signed.html.md.erb index f5a8852..72298da 100644 --- a/self-signed.html.md.erb +++ b/self-signed.html.md.erb @@ -4,14 +4,14 @@ owner: CLI --- This topic describes how developers use the Cloud Foundry Command Line Interface (cf CLI) -to communicate securely with a Cloud Foundry deployment with a self-signed certificate. +to communicate securely with a Cloud Foundry deployment that uses a self-signed certificate. You can use the cf CLI to communicate securely with a Cloud Foundry deployment without specifying `--skip-ssl-validation` under the following conditions: * The deployment uses a self-signed certificate. -* The deployment uses a certificate that is signed by a self-signed certificate authority (CA), or a certificate signed by a certificate that is signed by a self-signed CA. +* The deployment uses a certificate that is signed by a self-signed certificate authority (CA), or by an intermediate certificate that is also signed by a self-signed CA. <%= vars.self_signed %> @@ -22,11 +22,11 @@ The certificates you must insert into your local trust store vary depending on t * If the deployment uses a self-signed certificate, you must insert the self-signed certificate into your local trust store. -* If the deployment uses a certificate that is signed by a self-signed CA, or a certificate signed by a certificate that is signed by a self-signed CA, you must insert the self-signed certificate and any intermediate certificates into your local trust store. +* If the deployment uses a certificate signed by a self-signed CA, or a certificate signed by a certificate that is signed by a self-signed CA, you must insert the self-signed certificate and any intermediate certificates into your local trust store. -### Installing the Certificate on Mac OS X +### Installing the Certificate on macOS X -To place the certificate file `server.crt` into your local trust store for Mac OS X: +To place the certificate file `server.crt` into your local trust store for macOS X: 1. Run: diff --git a/use-cli-plugins.html.md.erb b/use-cli-plugins.html.md.erb index fea75c8..693bdea 100644 --- a/use-cli-plugins.html.md.erb +++ b/use-cli-plugins.html.md.erb @@ -4,17 +4,17 @@ owner: CLI --- -The Cloud Foundry CLI (cf CLI) includes plug-in capability. The plug-in allows you to add custom commands to the cf CLI. +The Cloud Foundry CLI (cf CLI) includes plug-in capability. Plug-ins allow you to add custom commands to the cf CLI. You can install and use the plug-in that Cloud Foundry developers and third-party developers create. For a current list of community-supported plug-ins, see the [Cloud Foundry Community CLI Plug-in page](https://plugins.cloudfoundry.org). For information about submitting your own plug-in, see the [Cloud Foundry CLI Plugin Repository (CLIPR)](https://github.com/cloudfoundry-incubator/cli-plugin-repo) repository on GitHub.

    Important -Plug-ins are not vetted, including for security or function. Use plug-ins at your own risk.

    +Plug-ins are not vetted for security or function. Use plug-ins at your own risk.

    The cf CLI identifies a plug-in by binary filename, its developer defined plug-in name, and the commands that the plug-in provides. Use the binary filename only to install a plug-in. You use the plug-in name or a command for any other action. -The cf CLI uses case sensitive commands, but plug in management commands accept plug-in and repository names +The cf CLI uses case-sensitive commands, but plug-in management commands accept plug-in and repository names irrespective of their casing. @@ -65,7 +65,7 @@ To manage plug-ins and run plug-in commands: ``` cf PLUGIN-COMMAND ``` - Where `PLUGIN-COMMAND` is the plug-in command you ran. + Where `PLUGIN-COMMAND` is the plug-in command that you want to run. ## Checking for plug-in updates @@ -107,7 +107,7 @@ To uninstall a plug-in: ``` Where `PLUGIN-NAME` is the name of the plug-in you want to uninstall. -

    You must use the name of the plug-in to uninstall it, not the binary filename.

    + You must use the name of the plug-in, not the binary filename, to uninstall it. For more information, see [uninstall-plugin](http://cli.cloudfoundry.org/en-US/cf/uninstall-plugin.html) in the _Cloud Foundry CLI Reference Guide_. @@ -120,7 +120,7 @@ To add a plug-in repository: ``` cf add-plugin-repo REPOSITORY-NAME-URL ``` - Where `REPOSITORY-NAME-URL` is the URL of the plug-in repository you want to add. + Where `REPOSITORY-NAME-URL` is the URL of the plug-in repository that you want to add. For more information, see [add-plugin-repo](http://cli.cloudfoundry.org/en-US/cf/add-plugin-repo.html) in the _Cloud Foundry CLI Reference Guide_. @@ -153,7 +153,7 @@ For more information, see [repo-plugins](http://cli.cloudfoundry.org/en-US/cf/re ## Troubleshooting -The cf CLI provides the following error messages to help you troubleshoot installation and usage issues. Third party plug-ins provide their own error messages. +The cf CLI provides the following error messages to help you troubleshoot installation and usage issues. Third-party plug-ins provide their own error messages. ### Permission denied diff --git a/v7.html.md.erb b/v7.html.md.erb index fe04681..5c10753 100644 --- a/v7.html.md.erb +++ b/v7.html.md.erb @@ -4,13 +4,15 @@ owner: VAT --- -The main goal of Cloud Foundry CLI (cf CLI) v7 and CAPI V3 is to unlock new app developer workflows for users who require granular control of their apps and other advanced deployment strategies. For more information, see [New Workflows Supported](#new-workflows) below. These workflows were previously limited by CAPI V2. +The main goal of Cloud Foundry Command Line Interface (cf CLI) v7 and CAPI V3 is to unlock new app developer workflows for users who require granular control of +their apps and other advanced deployment strategies. For more information, see [New Workflows Supported](#new-workflows) below. These workflows were previously +limited by CAPI V2. The cf CLI development team aims to provide: * A seamless upgrade experience from cf CLI v6. Changes have been kept to a minimum. Where there are changes, the team has incorporated feedback from the community to simplify the cf CLI user experience. -* Details about breaking potential breaking changes and alternative workflows for scripting environments. +* Details about potential breaking changes and alternative workflows for scripting environments. To understand the differences between specific commands, see [Command Differences](#differences) below. @@ -18,7 +20,7 @@ For more information about CAPI V3, see the [CAPI V3 documentation](https://v3-a ## New workflows supported by cf CLI v7 -cf CLI v7 uses CAPI V3, which offers developers more granular control over their apps. It activates new workflows by exposing packages, droplets, builds, and processes. CAPI V3 also includes new resources. For example, sidecars, manifests, and deployments. +cf CLI v7 uses CAPI V3, which offers developers more granular control over their apps. It activates new workflows by exposing packages, droplets, builds, and processes. CAPI V3 also includes new resources, for example, sidecars, manifests, and deployments. Some key new features available with the cf CLI v7 are: @@ -30,7 +32,7 @@ Some key new features available with the cf CLI v7 are: * [Pushing Apps with Sidecar Processes](../devguide/sidecars.html): Run additional processes in the same container as your app. -* [Using Metadata](../adminguide/metadata.html): Add metadata to objects, for example, spaces, and apps. This helps with operating, monitoring, and auditing. +* [Using Metadata](../adminguide/metadata.html): Add metadata to objects, for example, spaces, and apps. This aids in operations, monitoring, and auditing. ## Installing cf CLI v7 @@ -54,7 +56,7 @@ For example, `cf apps` does not work. These sections describe changes in commands from cf CLI v6 to cf CLI v7. They also provide important information for those who use the cf CLI in scripts. -For information about possible breaking changes, see the [Table of Differences](#table) below. This table includes removed flag options, removed commands, and removed or changed argument requirements. +For information about potential breaking changes, see the [Table of Differences](#table) below. This table includes removed flag options, removed commands, and removed or changed argument requirements. ### About scripting @@ -66,7 +68,7 @@ Some of these changes are: * cf CLI v7 commands output errors and warnings to `stderr` rather than `stdout` to simplify debugging. -* Style changes including flavor text updates. For more information, see [Colors](https://github.com/cloudfoundry/cli/wiki/CF-CLI-Style-Guide#colors) in _CF CLI Style Guide_ in the Cloud Foundry CLI repository on GitHub. +* Style changes including flavor text updates. For more information, see [Colors](https://github.com/cloudfoundry/cli/wiki/CF-CLI-Style-Guide#colors) in _cf CLI Style Guide_ in the Cloud Foundry CLI repository on GitHub. * Key-value and table column headers are displayed in lowercase. @@ -78,7 +80,7 @@ If the services attribute is declared at the top-level of the manifest.yml file, ### Exit codes -cf CLI v7 attempts to consistently apply the principles of idempotency across all commands which require it. For more information, see [General Principles](https://github.com/cloudfoundry/cli/wiki/CF-CLI-Style-Guide#general-principles) in _CF CLI Style Guide_ in the Cloud Foundry CLI repository on GitHub. Commands now exit `0` if the outcome a user expresses when running a specific command is unchanged after the command is executed. Examples include: +cf CLI v7 attempts to consistently apply the principles of idempotency across all commands which require it. For more information, see [General Principles](https://github.com/cloudfoundry/cli/wiki/CF-CLI-Style-Guide#general-principles) in _cf CLI Style Guide_ in the Cloud Foundry CLI repository on GitHub. Commands now exit `0` if the outcome a user expresses when running a specific command is unchanged after the command is executed. Examples include: * Attempting to delete a resource which does not exist, for example, a space. Commands like `delete-route` and `delete-space` return `0` in those cases. @@ -199,7 +201,7 @@ The following table summarizes how commands differ between cf CLI v7 and cf CLI     		cf create-user
      -
    • [Added flag]: --password-prompt. This option enhances security by removing the requirement to type your password on the command line.
      • +
    • [Added flag]: --password-prompt. This option enhances security by eliminating the need to enter your password directly on the command line.
    cf map-route
      -
    • [Added flag]: Use --destination-protocol to use HTTP/2 protocol to communicate with apps. By default, if destination-protocol is not set, HTTP/1 protocol is used for HTTP route.
      • +
    • [Added flag]: Use --app-protocol to use HTTP/2 protocol to communicate with apps. By default, if app-protocol is not set, HTTP/1 protocol is used for HTTP route.
    cf upgrade-service
      -
    • [Removed flag]: --force. There is no longer user interaction required on this command.
      • +
    • [Added flag]: --force. There is no longer user interaction required on this command.