feat(fleetcontrol): Add a new package to support managing Fleet Control Ops by pranav-new-relic · Pull Request #1794 · newrelic/newrelic-cli

pranav-new-relic · 2026-02-19T07:42:42Z

Overview

This PR introduces a complete set of Fleet Control commands for managing New Relic's Fleet Management system, providing CLI access to fleets, configurations, deployments, and entity management.

🚀 Features

Core Command Structure

Implemented a new fleetcontrol package with a YAML-driven command generation framework that provides:

Declarative command definitions - Commands defined in YAML with automatic flag generation
Type-safe flag handling - Strongly-typed flag access with validation
Automatic help text generation - Rich help and examples from YAML configuration
Consistent error handling - Unified error reporting across all commands

Command Categories

1. Fleet Management (`newrelic fleetcontrol fleet`)

create - Create a new fleet with name and optional description
get - Retrieve fleet details by GUID
update - Update fleet name and/or description
delete - Delete a fleet by GUID
search - Search fleets with optional name filter

2. Fleet Members (`newrelic fleetcontrol fleet members`)

add-members - Add entities to a fleet
remove-members - Remove entities from a fleet
list-members - List all members of a fleet with filtering and pagination

3. Configuration Management (`newrelic fleetcontrol configuration`)

create - Create fleet configuration with schema and variables
get - Retrieve configuration by GUID or entity GUID
delete - Delete a configuration
Version Management:
- add-version - Add new version to configuration
- list-versions - List all versions of a configuration
- delete-version - Delete a specific version

4. Deployment Management (`newrelic fleetcontrol deployment`)

create - Create new deployment with agent type and version specification
update - Update deployment parameters
delete - Remove a deployment
deploy - Execute deployment with confirmation/force options

5. Entity Management (`newrelic fleetcontrol entities`)

get-managed - List entities managed by Fleet Control
get-unassigned - List entities not assigned to any fleet

Technical Highlights

YAML-Driven Command Framework

name: fleet-create
use: create
short: Create a new fleet
flags:
  - name: name
    type: string
    required: true
    description: The name of the fleet
    validation:
      minLength: 1
      maxLength: 256

Commands are automatically generated from YAML definitions with:

Flag registration and validation
Help text and examples
Required/optional flag handling
Type conversion and safety

📝 Documentation

README.md

Comprehensive documentation including:

Prerequisites and setup instructions
Available commands quick reference
Detailed command usage with examples
Response format documentation
Validation rules reference
Troubleshooting guide
Workflow examples (create fleet, configure, deploy)

…, configuration, deployments and more Adds complete fleet control functionality with a modular, YAML-driven command framework: Fleet Management: - Create, get, update, delete, and search fleet entities - Bulk delete support with --ids flag - Type-safe flag accessors and declarative validation Configuration Management: - Create, get, delete configurations - Add, list, and delete configuration versions - Split file flags: --configuration-file-path (recommended) and --configuration-content (testing) - Renamed --entity-guid to --configuration-guid in get-versions for clarity - Empty results validation with meaningful error messages Deployment & Members: - Create and update fleet deployments - Add and remove fleet members with ring support Response Format: - Consistent JSON output with status/error fields across all commands - Search and get-configuration return raw data for table formatting - Field ordering preserved (status first, error second) Framework Features: - YAML configs embedded at compile time with validation - Generated typed flag structs for compile-time safety - Shared helpers for output formatting and type mapping - Strict file reading (file type flags require valid file paths) Documentation: - Comprehensive README with command examples and jq usage - Validation testing guide with JSON response examples - Complete API reference for all commands Go Client Integration: - Uses local client via go.mod replace directive - Fixed delete operations to handle empty API responses

Restructured README.md to be more intuitive and user-friendly: - Added clear introduction with Fleet Control capabilities overview - Added comprehensive prerequisites section with: - Required environment variables (NEW_RELIC_API_KEY, NEW_RELIC_ACCOUNT_ID) - Step-by-step guide for getting credentials - Build and verification instructions - Added "Available Commands" quick reference section listing all commands - Reorganized content flow: 1. Introduction and directory structure 2. Commands quick reference 3. Prerequisites and setup 4. Detailed command reference 5. Response formats and jq usage 6. Validation rules 7. Troubleshooting - Added practical workflow examples for common use cases - Added debug mode instructions for troubleshooting - Added authentication error troubleshooting - Kept experimental commands (deployment and member management) clearly marked

…pdate deployment

Add new deployment delete command: - Created fleet_deployment_delete.yaml config - Created fleet_deployment_delete.go handler - Added DeleteDeploymentFlags to command_flags_generated.go - Added PrintDeploymentDeleteSuccess helper function - Registered command in command_fleet.go Enhanced README: - Added comprehensive table of contents with all sections - Updated command hierarchy to include delete deployment - Added documentation for delete deployment command - Updated directory structure listing

- Add individual command entries under each category in TOC - Update all command headers to include full syntax in backticks - Format: `fleetcontrol <resource> <action>` for better discoverability - All 20 commands now have consistent header formatting

Removed integration and unit tests that reference commands that no longer exist: - command_fleet_config_test.go (cmdFleetGetConfiguration, cmdFleetAddVersion) - command_fleet_test.go (cmdFleetAddMembers, cmdFleetRemoveMembers, cmdFleetCreateConfiguration) - command_configuration_integration_test.go - command_fleet_integration_test.go - command_deployment_members_integration_test.go - command_test.go These tests were causing build failures with undefined references.

…tag conversion Changed from struct literal to direct type conversion when converting EntityManagementTag to FleetControlTag, as both types have identical structure. This resolves gosimple linter warning S1016. - Before: fleetcontrol.FleetControlTag{Key: tag.Key, Values: tag.Values} - After: fleetcontrol.FleetControlTag(tag)

shashank-reddy-nr

LGTM

- Remove non-existent TOC entries (Building the CLI, For Developers, Recent Updates) - Condense Getting Your Credentials section for brevity - Add note about user capabilities in Verifying Setup section - Fix flag name: change --include-tags to --show-tags in fleet members list command

- Add missing periods at end of complete sentences in validation and optional flag descriptions - Improve consistency of punctuation throughout the document - No content changes, only punctuation fixes for better readability

shashank-reddy-nr

LGTM

nr-developer-toolkit

looks good to me too, @pranav-new-relic

pranav-new-relic · 2026-02-19T09:42:46Z

Thank you @shashank-reddy-nr @nr-developer-toolkit ; shipping this 🚀

pranav-new-relic added 9 commits January 27, 2026 22:17

chore: add a new command to fetch fleet members

2d15eeb

feat(fleetcontrol): launch, T-4 16 February 2026 version

7995516

chore: merge branch 'main' into fleet-control-starts-here

a1ff027

chore: add * validation on agentType, fix argument issues - create, u…

2a90c65

…pdate deployment

chore: tiny change

3491c3d

pranav-new-relic force-pushed the fleet-control-starts-here branch from 0534250 to 3491c3d Compare February 19, 2026 07:48

pranav-new-relic added 5 commits February 19, 2026 13:21

chore: apply code formatting and linter suppressions

80509e7

chore: sync with main branch

3c3c8bb

chore: address lint failures

60671dd

shashank-reddy-nr previously approved these changes Feb 19, 2026

View reviewed changes

pranav-new-relic marked this pull request as ready for review February 19, 2026 08:17

chore: upgrade New Relic Go Client to v2.79.0, FC suite

a906d8d

pranav-new-relic dismissed shashank-reddy-nr’s stale review via a906d8d February 19, 2026 08:22

shashank-reddy-nr previously approved these changes Feb 19, 2026

View reviewed changes

pranav-new-relic dismissed shashank-reddy-nr’s stale review via 34976d4 February 19, 2026 09:28

docs(fleetcontrol): fix grammar and punctuation in README

2918679

- Add missing periods at end of complete sentences in validation and optional flag descriptions - Improve consistency of punctuation throughout the document - No content changes, only punctuation fixes for better readability

shashank-reddy-nr approved these changes Feb 19, 2026

View reviewed changes

nr-developer-toolkit approved these changes Feb 19, 2026

View reviewed changes

pranav-new-relic merged commit 910bd6b into main Feb 19, 2026
29 checks passed

pranav-new-relic deleted the fleet-control-starts-here branch February 19, 2026 09:43

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(fleetcontrol): Add a new package to support managing Fleet Control Ops#1794

feat(fleetcontrol): Add a new package to support managing Fleet Control Ops#1794
pranav-new-relic merged 17 commits intomainfrom
fleet-control-starts-here

pranav-new-relic commented Feb 19, 2026 •

edited

Loading

Uh oh!

shashank-reddy-nr left a comment

Uh oh!

shashank-reddy-nr left a comment

Uh oh!

nr-developer-toolkit left a comment

Uh oh!

pranav-new-relic commented Feb 19, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Comments

Conversation

pranav-new-relic commented Feb 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Overview

🚀 Features

Core Command Structure

Command Categories

1. Fleet Management (newrelic fleetcontrol fleet)

2. Fleet Members (newrelic fleetcontrol fleet members)

3. Configuration Management (newrelic fleetcontrol configuration)

4. Deployment Management (newrelic fleetcontrol deployment)

5. Entity Management (newrelic fleetcontrol entities)

Technical Highlights

YAML-Driven Command Framework

📝 Documentation

README.md

Uh oh!

shashank-reddy-nr left a comment

Choose a reason for hiding this comment

Uh oh!

shashank-reddy-nr left a comment

Choose a reason for hiding this comment

Uh oh!

nr-developer-toolkit left a comment

Choose a reason for hiding this comment

Uh oh!

pranav-new-relic commented Feb 19, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Comments

pranav-new-relic commented Feb 19, 2026 •

edited

Loading

1. Fleet Management (`newrelic fleetcontrol fleet`)

2. Fleet Members (`newrelic fleetcontrol fleet members`)

3. Configuration Management (`newrelic fleetcontrol configuration`)

4. Deployment Management (`newrelic fleetcontrol deployment`)

5. Entity Management (`newrelic fleetcontrol entities`)