docs

Author: gsanchezgavier

test/ac-ansible-roles/install_ac_recipe/Readme.md

@@ -0,0 +1,19 @@
+# Install AC Recipe Role
+
+This Ansible role handles the installation of Agent Control (AC) using a recipe-based approach.
+
+## Features
+
+- Installs AC using the designated recipe
+- Supports targeting specific recipe repository branches
+- Utilizes local package repository for installation
+- Installs from locally built .deb packages corresponding to the current branch
+
+## Usage
+
+This role creates a local repository on the target host and installs the AC package from the built .deb file, ensuring consistency with the current development branch.
+
+## Requirements
+
+- Target host must support .deb package installation
+- Local .deb package must be available from the current branch build

test/ac-ansible-roles/install_ac_recipe/vars/main.yaml

@@ -1,18 +1,36 @@
 ---
+# List of recipes to be installed
 recipe_list: "agent-control"
+
+# Source of monitoring configuration ("infra-agent", "otel")
 monitoring_source: "none"
+
+# Unique identifier for the fleet this agent belongs to
 fleet_id: ""
+
+# Flag to enable or disable fleet management functionality
 fleet_enabled: "true"
-migrate_infra_config: "true" 
 
+# Flag to migrate existing infrastructure agent configuration
+migrate_infra_config: "true"
+
+# Local file system path where local packages (.deb) exists.
 local_package_path: ""
+
+# Git branch name to use when fetching recipes from the repository
 recipe_repo_branch: "main"
 
+# Specific version of the agent control software to install
 agent_control_version: ""
 
+# New Relic license key for agent authentication
 nr_license_key: ""
+
+# New Relic API key for programmatic access to New Relic services
 nr_api_key: ""
+
+# New Relic account identifier for associating the agent
 nr_account_id: ""
-nr_region: ""
-...
 
+# New Relic region endpoint (e.g., "US", "EU") for data reporting
+nr_region: ""