Architecture Guide

Page under construction.

CF CLI Architecture Diagram

The CF CLI master branch contains both the V6 and V7 CLIs:

Glossary:

• main.go (Orange): Entry point into the CF CLI.
• Command Lists (Grey): List of CLI commands contained in that version of the CF CLI. This is dependent on the build tags provided to GoLang at compile time.
• Command Packages (Yellow): These packages manage the UX/UI logic for each individual command.
• Actor Packages (Teal): These packages manage the business logic for the entire CLI. The V6 CLI actors are divided by Cloud Controller API version; the push and V2/V3 actors are required to mitigate the complexity of integrating the V2 and V3 API versions. The V7 CLI utilizes the V7 Actor package for V7 specific commands.
• API Packages (Green): These packages manage the API requests made to the Cloud Controller/UAA/Networking/etc. These API requests do not contain any business logic; they are simple abstractions of individual API requests.

General Command Flow

When a CLI command runs, the following process occurs to execute the requested action:

1. All the command line arguments (aka os.Args) are provided to the go-flags package with the appropriate command list.
2. Based on the command tag from the command list and the command line arguments, go-flags will instantiate the correct command struct, populating the struct's fields based off of the provided short/long flags listed in the command struct's tags.
3. The command's Setup method is called with a preloaded UI and an in memory copy of the CLI config. This Setup method creates all the necessary API clients and Actors required for the command.
4. The command's Execute method is called; the Execute method [generally] runs through the following:
   1. Validates/sanitizes the user provided input.
   2. API version checking based on provided input.
   3. Verifies API targets based on command requirements.
   4. Outputs "flavor" text to indicate to the user that desired action is about to be processed.
   5. Calls appropriate Actor function(s) to perform command's action. (See step #5 for more information)
   6. Displays output of Actor methods depending on command's intent.
5. When an Actor function is called, one or more API calls are made to the Cloud Controller, UAA, Networking API, etc. in order to perform the desired action. Any complex logic regarding the return of these APIs are handled within the Actor function, returning the final result of said API calls or an error indicating why the Actor function could not proceed.

V7 Exclusive Packages/Files

Outside of the command/common package (which uses GoLang Build tags), the V7 CLI uses all the V6 packages with the addition of actor/v3action and command/v7:

├── actor
│   └── v7actor
└── command
    ├── common
    │   ├── command_list_v7.go # Different Command list
    │   └── internal
    │       ├── help_all_display_v7.go # Different help list
    │       └── help_common_display_v7.go # Different help list
    └── v7 # Over written V7 versions of V6 commands

Need to fill in the following

• V6 vs V7
• Legacy vs Rewrite