From 22666d15532cf5dbd236816ac141aa4c2c3c3d9d Mon Sep 17 00:00:00 2001 From: ian-bartholomew Date: Wed, 23 Mar 2022 15:10:03 -0700 Subject: [PATCH] Updating docs --- README.md | 60 +++++++++++++++++++++++++++---------------------------- 1 file changed, 30 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index e6b66cb..6a1e383 100644 --- a/README.md +++ b/README.md @@ -1,44 +1,44 @@ # nobl9-action -This action is applying a nobl9 configuration file (specified at `sloctl_yml` input parameter) to a project using `sloctl` (https://docs.nobl9.com/sloctl-user-guide/) tool. +This action applies a Nobl9 configuration file (specified at `sloctl_yml` input parameter) to a project using `sloctl` (https://docs.nobl9.com/sloctl-user-guide/) tool. -# Requirements +## Requirements -- Before running this action, the code must be checked out already (see https://github.com/actions/checkout). - A valid nobl9 account must be activated (check https://nobl9.com for more information) +## Inputs -# Usage +### `client_id` +The Client ID of your nobl9 account -This action supports GitHub actions secrets in all the input parameters. More details: https://docs.github.com/en/actions/reference/encrypted-secrets. +### `client_secret` +The Client Secret of your nobl9 account -Example: -```yaml -- uses: nobl9/nobl9-action@v0.2.0 - with: - # This references to a custom `NOBL9_CLIENT_ID` secret defined in GitHub project settings - client_id: ${{ secrets.NOBL9_CLIENT_ID }} -``` - -Input parameters: +### `access_token` +Access token used to authenticate the sloctl tool - -```yaml -- uses: nobl9/nobl9-action@v0.2.0 - with: - # The Client ID of your nobl9 account - client_id: '' - - # The Client Secret of your nobl9 account - client_secret: '' +### `project` +The project name on which the sloctl configuration will be applied to - # Access token used to authenticate the sloctl tool - access_token: '' +### `sloctl_yml` +The path to the sloctl yaml configuration file, relative to the root directory of the repository - # The project name on which the sloctl configuration will be applied to - project: '' +## Example Usage - # The path to the sloctl yaml configuration file, relative to the root directory of the repository - sloctl_yml: '' +```yaml +name: Nobl9 GitHub Actions Demo +on: [push] +jobs: + nobl9: + runs-on: ubuntu-latest + steps: + - name: Check out repository code + uses: actions/checkout@v2 + - uses: nobl9/nobl9-action@v0.2.0 + with: + client_id: ${{ secrets.CLIENT_ID }} + client_secret: ${{ secrets.CLIENT_SECRET }} + access_token: ${{ secrets.ACCESS_TOKEN }} + project: "myproject" + sloctl_yml: "slos.yaml" ``` -