[RFC0045] Enhance Stack Handling in Cloud Foundry

[beyhan]

This is a tracking issue for RFC0045.

Delivered with:

• CF-Deployment version: v54.11.0
• CLI version: v8.18.0
• CF Docs: https://docs.cloudfoundry.org/devguide/deploy-apps/stacks.html#stack-states

Tasks

• Stack management cloud_controller_ng#4712
• RFC-0045 Update stack states from LOCKED to RESTRICTED #1405
• [main] RFC-0045: Stack management cli#3688
• Add state_reason in Stack object cloud_controller_ng#4823
• [V8] RFC-0045: Stack Management Reason cli#3718
• [v8] RFC-0045: Stack management cli#3687

[rashedkvm]

New CF CLI command update-stack

cf update-stack -h
NAME:
   update-stack - Transition a stack between the defined states

USAGE:
   cf update-stack STACK_NAME [--state (active | restricted | deprecated | disabled)] --reason [ text ]

EXAMPLES:
   cf update-stack cflinuxfs3 --state disabled --reason "This stack is based on Ubuntu 18.04, which is no longer supported. Please migrate your applications to 'cflinuxfs4'. For more information, see: <link-to-docs>."

OPTIONS:
   --state      State to transition the stack to (active, restricted, deprecated, disabled)
   --reason     Optional plain text describing the stack state change

SEE ALSO:
   stack, stacks

Adds stack state to the existing stack command.

Displays reason for state != ACTIVE

cf stack windows
Getting info for stack windows as admin...

name:          windows
description:   Windows Server
state:         RESTRICTED
reason:        Windows Server 2010 is no longer supported, please update your application to use latest Window 11. For more information see {URL}

Adds stack state to the existing stacks command.

cf stacks
Getting stacks as admin...

name         description                                                    state
cflinuxfs4   Cloud Foundry Linux-based filesystem - Ubuntu Jammy 22.04 LTS  ACTIVE
windows      Windows Server                                                 RESTRICTED

[rashedkvm]

CF CLI (V8) pull request with Stack state managment cloudfoundry/cli#3687

[rashedkvm]

Please note PR open for stack state_reason State reason cloud_controller_ng#4823

[rashedkvm]

CLI PR to add state_reason cloudfoundry/cli#3718

[rashedkvm]

@beyhan We are currently waiting for the stack management updates in the upcoming CLI release. In the meantime, could you point us toward the relevant CF Docs where we need to add the stack management instructions. Thank you!

[beyhan]

Hi @rashedkvm,

thank you for the update! I think the docs should be added in https://docs.cloudfoundry.org/adminguide/managing-apps-stacks-index.html. What do you think @anita-flegg?

[rashedkvm]

Hi @beyhan I believe the following contains the related CF releases for the Enhanced Statck Management feature

• CF-Deployment version: v54.11.0
• CLI version: v8.18.0
• CF Docs: @anita-flegg can provide the docs version

[beyhan]

Thank you @rashedkvm for the contributions and the great tracking feedback about the made contributions!