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

Reorganize SensuFlow readme #45

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Reorganize SensuFlow readme #45

wants to merge 1 commit into from

Conversation

hillaryfraley
Copy link

Reorganizes content in the existing readme as well as pages in https://github.com/sensu/sensu-flow/tree/main/docs.

  • Separates GitHub Action-specific info into a separate page within the /docs directory
  • Rearranges readme content under logical headings
  • Revises and updates readme content and info in CI/CD-specific /docs pages
  • Adds some info taken from https://sensu.io/blog/monitoring-as-code-with-sensu-flow

Closes #44


## Install SensuFlow

**TODO**
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What do users need to clone/download/install to use SensuFlow in their own repos? Is it something like this:

  1. Clone the SensuFlow repo (or reproduce it in Bitbucket or GitLab, if not using GitHub).
  2. Add your namespace directories and resource files (with appropriate labels and following the prescribed directory structure).
  3. Configure the Sensu RBAC service account.
  4. Configure env vars required to use SensuFlow and aspects of the CI/CD service (secrets; pipeline files; other).

Anything else?

Is there a different install process for people who the Docker image?


### Set environment variables

**TODO**
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are env vars for SensuFlow set differently than env vars for Sensu? -- or does this depend on the CI/CD service in use?

@hillaryfraley
Copy link
Author

hillaryfraley commented Jul 13, 2022

Hey @jspaleta please let me know if I missed the mark or you need further help here! After straightening out the install process (such as it may be), I can probably make a few more updates in the readme.

SENSU_API_URL | String | Required | Sensu backend API URL (the URL used to configure `sensuctl`, such as `https://sensu.example.com:8080`).
SENSU_CA | String | Optional | Certificate Authority (CA) file as a string. Use the SENSU_CA variable if you want to encode the CA file as a GitHub Actions secret.
SENSU_CA_FILE | String | Optional | Certificate Authority (CA) file location. The SENSU_CA_FILE value (if provided) overrides the SENSU_CA value.
VERBOSE | Integer | Optional | If set, shows verbose description of actions carried out by the script.
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure if VERBOSE should be included here or not.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Let's make the readme usable.
1 participant