Skip to main content

Rapid Rollout (SSM/Intune)

Use this playbook to roll out Breeze Agent quickly and safely across fleets using AWS Systems Manager (SSM) and Microsoft Intune.

Prerequisites​

  • For Amazon SSM:
    • Systems Manager enabled and configured on target instances.
  • For Intune:
    • Windows 10/11 or Windows Server endpoints enrolled in Intune.

Download the Installers​

  1. In Cloudaware, go to Admin.
  2. Find Breeze in DevOps Integrations. Click CONFIGURED.
  3. Download:
    • Linux installer archive (breeze-agent*.tgz).
    • Windows installer (breeze-agent*.exe).
note

For outbound network access for Breeze, see Service Endpoints & Public IPs.

Create Deployment Packages​

AWS Systems Manager​

Breeze Package Sharing​

Enable Breeze package sharing in Cloudaware so the package appears under Shared with me in SSM Distributor (see Breeze Package Sharing).

Custom Package​

  • Create an SSM Distributor package that:
    • Downloads the Breeze installer.
    • Runs the Linux install.sh or Windows EXE.
  • Use State Manager or Run Command to target instances.

Microsoft Intune​

  1. Wrap the Windows installer as a Win32 app using the Microsoft Win32 Content Prep Tool.
  2. Use an install command similar to:
    • "%systemroot%\\sysnative\\cmd.exe" /c "install.cmd" (where install.cmd runs the Breeze installer).
  3. Use an uninstall command:
    • "%systemroot%\\sysnative\\cmd.exe" /c "%ProgramFiles%\\Breeze\\uninstall.bat".
  4. Configure detection rules so Intune treats the app as installed only when C:\\Program Files\\Breeze exists.

Pilot and Validate​

  1. Target a small pilot group (for example, a single environment or OU).
  2. Verify that:
    • Hosts appear in the Cloudaware CMDB with recent Breeze check‑ins.
    • Logs (/opt/breeze-agent/var/log/breeze-agent.log or C:\\Program Files\\Breeze\\agent.log) show successful runs.
  3. Address any connectivity, proxy, or permission issues before expanding.

Expand Rollout​

  • Roll out in waves based on:
    • Environment (dev → test → prod).
    • Region, business unit, or platform.
  • Use:
    • SSM maintenance windows for controlled deployment windows.
    • Intune assignment groups and phased deployments.
  • Monitor last check‑ins, error rates, and resource usage as you expand coverage.