| Info |
|---|
This article instructs on explains how to create a Breeze Agent Deployment via deploy Cloudaware Breeze agent using AWS Systems Manager Distributor. |
| Table of Contents |
|---|
Description
...
|
Automatic installation using Breeze Package sharing in Cloudaware CMDB
Requirements
1. Ensure AWS Systems Manager is enabled and configured in your AWS environment. Read more
2. Ensure that your AWS account is added to Cloudaware.
Enable package sharing
1. Log in to Cloudaware account → Admin.
2. Find Breeze in the list of DevOps integrations. Click +Add (or +N Configured).
3. Click on the toggle switch next to 'Breeze Package Sharing (AWS only)' to share the Cloudaware Breeze Package for AWS Systems Manager.
...
To check the package, log in to AWS Console → AWS System Manager → Distributor → Shared with me.
Manual package creation for AWS Systems Manager Distributor (deprecated)
Use this option to manually create a package with Breeze Agent. The distributor Distributor publishes this package to System Manager-managed instances. Then the agent can be installed or uninstalled:
one time by using AWS Systems Manager Run Command
on a schedule by using AWS Systems Manager State Manager
Prerequisites
The distributor package consists of a manifest and two .zip archive files for Windows and Linux platforms. Each archive contains install and uninstall scripts, as well as Breeze Agent distro respectively to the platform. The manifest template and scripts can be obtained from Github from the GitHub repository.
In the file manifest.json, find the field "version" and change its value to something a meaningful one. This is also the The value of Version a version name that should also be specified when the package will be is added to the Distributor (it becomes a part of the AWS Systems Manager document). A The version value can contain letters, numbers, underscores, hyphens, and periods, and be from 3 to 128 characters in length. It is recommended to use Using a human-readable value is recommended.
Preparing
...
package files
A Linux archive named breeze-agent-linux.zip should contain next such files : as install.sh, uninstall.sh and agent.XXX.YY.Z.x86_64.linux.tgz (the Linux Breeze Agent distro as it was downloaded from CMDB).
A Windows archive named breeze-agent-windows.zip should contain such files as : install.ps1, uninstall.ps1 and agent.XXX.YY.Z.windows.signed.exe (the Windows Breeze Agent distro as it was downloaded from CMDB).
| Note |
|---|
Ensure that the script files have the correct lines breaks, namely |
...
For each archive file mentioned in the manifest, a sha256 checksum should be specified a sha256 checksum. In order to . To calculate it, the following commands can be used:
Linux:
shasum -a 256 file-name.ziporopenssl dgst -sha256 file-name.zipWindows:
Get-FileHash -Path file-name.zip(PowerShell)
In the manifest.json, find the section "files" and replace ARCHIVE_CHECKSUM placeholders with the calculated checksums.
...
Package creation
In Create an Advanced package in the AWS Systems Manager create an Advanced package , as described in AWS documentation.