https://github.com/cloudfoundry/upgrade-all-services-cli-plugin

https://github.com/cloudfoundry/upgrade-all-services-cli-plugin

cff-wg-service-management

Last synced: 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/cloudfoundry/upgrade-all-services-cli-plugin
• Owner: cloudfoundry
• License: apache-2.0
• Created: 2022-06-29T11:18:11.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-17T18:05:46.000Z (3 months ago)
• Last Synced: 2024-10-20T03:08:42.761Z (3 months ago)
• Topics: cff-wg-service-management
• Language: Go
• Homepage:
• Size: 7.38 MB
• Stars: 1
• Watchers: 5
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: CODEOWNERS

Awesome Lists containing this project

README

        
## upgrade-all-services (cf-cli plugin)

A CF-CLI plugin for upgrading all service instances in a CF foundation.

### Purpose

This tool was developed to allow users to upgrade all service instances they have access to in a foundation, without having to navigate between orgs and spaces to discover upgradable instances.

**Warning:** It is important to ensure that the authenticated user only has access to instances which you wish to upgrade. The plugin will upgrade all service instances a user has access to, irrespective of org and space. 

### Installing

First build the binary from the plugin directory

```

go build .

```

Then install the plugin using the cf cli

```

cf install-plugin 

```

### Releasing

To create a new GitHub release, decide on a new version number [according to Semantic Versioning](https://semver.org/), and then:

1. Create a tag on the main branch with a leading `v`:

   `git tag vX.Y.X`

1. Push the tag:

   `git push --tags`

1. Wait for the GitHub action to run GoReleaser and create the new GitHub release

### Usage

```

cf upgrade-all-services  [options]

Options:

    -parallel                                 - number of upgrades to run in parallel (defaults to 10)

    -loghttp                                  - log HTTP requests and responses

    -dry-run                                  - print the service instances that would be upgraded

    -min-version-required  - checks and fails if any service instance has a version less than the minimum required 

    -check-up-to-date                         - checks and fails if any service instance is not up-to-date. An instance is not up-to-date if it is marked as upgradable or belongs to a deactivated plan

    -check-deactivated-plans                  - checks and fails if any of the plans have been deactivated

```

### Internals

#### Semver

Both the `github.com/blang/semver/v4` and `github.com/hashicorp/go-version` semver libraries are used. The aim is to use

`github.com/hashicorp/go-version` as the default and `github.com/blang/semver/v4` where needed. While you might imagine

that using one library would be cleaner than using two, we make use of unique features in each library. Attempts

have been made to standardise on one library, but it resulted in worse code, so we decided to continue to use two

libraries.