Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve the cookbook description and readme #27

Merged
merged 6 commits into from
Sep 14, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 12 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,12 @@
[![Cookbook Version](https://img.shields.io/cookbook/v/mondoo.svg)](https://supermarket.chef.io/cookbooks/mondoo)
[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)

This cookbook installs the Mondoo `cnquery` and `cnspec` on Linux servers.
This cookbook installs Mondoo `cnquery` and `cnspec` on Linux servers for infrastructure security, compliance, and asset intelligence.

It does:
The `default` cookbook recipe:

* Installs the signed `mondoo` package
* Login `cnquery` and `cnspec` with Mondoo Platform
* Logs in `cnquery` and `cnspec` with Mondoo Platform
* Enables the `cnspec` systemd service

## Requirements
Expand Down Expand Up @@ -39,25 +39,28 @@ It does:

## Run Mondoo Cookbook with chef-run

See [examples] for how use this cookbook with `chef-run`
See the `examples` directory for examples of using this cookbook with `chef-run`.

## Testing

Ensure docker and vagrant are installed and run:
```

```bash
MONDOO_TOKEN=ey...Bp KITCHEN_LOCAL_YAML=kitchen.dokken.yml kitchen test
```

(or add MONDOO_API_PROXY to the list of variables to test the setting/using of that variable)

You can "enter" the resulting environment used for the test by changing the 'test' kitchen command to 'login'.

You can reduce the number of environments tested (to speed local testing up) by commenting out unneccessary entries from kitchen.dokken.yml.
You can reduce the number of environments tested (to speed up local testing) by commenting out unnecessary entries from kitchen.dokken.yml.

## Release

This repo includes a GitHub action "Supermarket Release", which can be manually triggered to perform a release. Before running this workflow make sure to do the following:
- Update the metadata.rb file with the new version.
- Update the CHANGELOG.md file to document the new release.
This repo includes a GitHub action "Supermarket Release", which you can manually trigger to perform a release. Before running this workflow make sure to:

- Update the metadata.rb file with the new version.
- Update the CHANGELOG.md file to document the new release.

## Author

Expand Down
2 changes: 1 addition & 1 deletion examples/run/recipes/default.rb
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# This is really mitigating a bug in Chef. The `package` resoruce fails on a
# This is really mitigating a bug in Chef. The `package` resource fails on a
# fresh amazonlinux instance because Chef is not using Utf-8 properly
# This ensures all exec's by Chef use utf8 as locale
ENV['LANG'] = 'en_US.utf-8'
Expand Down
2 changes: 1 addition & 1 deletion metadata.rb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
maintainer 'Mondoo, Inc'
maintainer_email '[email protected]'
license 'Apache-2.0'
description 'Installs and configures Mondoo Client'
description 'Installs and configures Mondoo package for infrastructure security, compliance, and asset intelligence'
version '0.6.0'
chef_version '>= 14'
source_url 'https://github.com/mondoohq/chef-mondoo'
Expand Down