Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/azure/guest-configuration-extension
Azure Guest Configuration Virtual Machine Extension for Linux
https://github.com/azure/guest-configuration-extension
azure guestconfiguration in-guest policy
Last synced: 3 months ago
JSON representation
Azure Guest Configuration Virtual Machine Extension for Linux
- Host: GitHub
- URL: https://github.com/azure/guest-configuration-extension
- Owner: Azure
- License: apache-2.0
- Created: 2018-06-06T21:41:18.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-23T18:42:33.000Z (4 months ago)
- Last Synced: 2024-10-08T12:39:49.526Z (4 months ago)
- Topics: azure, guestconfiguration, in-guest, policy
- Language: Go
- Homepage:
- Size: 847 MB
- Stars: 12
- Watchers: 21
- Forks: 10
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[![Build Status](https://travis-ci.org/Azure/Guest-Configuration-Extension.svg?branch=master)](https://travis-ci.org/Azure/Guest-Configuration-Extension)
# Guest Configuration Extension for Linux
The Guest Configuration Extension for Linux configures the Guest Configuration
Agent on VMs. Together, they allow a customer to run In-Guest Policy on their
VMs, which gives the customer the ability to monitor their system and security
policies on their machines. In-Guest Policy for Linux currently uses policies
found on Chef InSpec.## 1. Deployment to a Virtual Machine
To deploy the Guest Configuration Extension for Linux onto your machine, run:
$ az vm extension set --resource-group --vm-name \
--name ConfigurationForLinux --publisher Microsoft.GuestConfiguration## 2. Commands Guide
The Guest Configuration Extension for Linux supports five commands -- install, enable,
update, disable, and uninstall. To run any of these commands, go to the path: `/var/lib/waagent/Microsoft.GuestConfiguration.ConfigurationForLinux-/bin`,
and run:$ guest-configuration-shim
##### Install
`Install` does not do anything in itself, but when the Guest Configuration Extension is
installed, `Enable` will be called immediately aftwards.##### Enable
`Enable` handles the configuration of the Guest Configuration Agent. It handles the unzipping of the Agent
package and then installs and enables the Agent.##### Update
`Update` will update the Agent Service to the new Extension. It parses the path of the old Agent, and gives it to the new Agent, so that the agent
can update the service endpoint.##### Disable
`Disable` disables the agent and returns the status to the user.##### Uninstall
`Uninstall` uninstalls the agent, and then the Guest Agent removes everything from the box.## 3. Troubleshooting
The agent is downloaded to a path like: `/var/lib/waagent/Microsoft.GuestConfiguration.ConfigurationForLinux-/GCAgent/GC`
and the Agent output is saved to `stdout` and `stderr` files in this directory. Please read
these files to find out output from the agent.You can find the logs for the extension at a path like: `/var/log/azure/Microsoft.GuestConfiguration.ConfigurationForLinux`.
Please open an issue on this GitHub repository if you encounter problems that
you could not debug with these log files.## 4. Future Plans
The Guest Configuration Extension for Linux will be made cross-platform to
support both Linux and Windows VMs. It will support all Azure endorsed distributions.-----
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.