Skip to content

Commit

Permalink
Updated README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Kerwood committed Nov 16, 2021
1 parent 0a09447 commit 6efdc91
Showing 1 changed file with 38 additions and 0 deletions.
38 changes: 38 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1 +1,39 @@
# Confluence Updater

If you like to keep your documentation in Git, love writing in markdown but are somehow required to deliver documentation in Confluence, look no further.

This tool will render your markdown files to html and upload it to a page in your Confluence Cloud instance via the API. I haven't tested it on a self hosted instance so I'm don't know if that will work.

Go to [https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens) and create an API token.

The tool looks for a `confluence-config.yaml` file in the present directory with the configuration for which markdown files to render and which page ID to update with the content. There's an example in the repo.

Run below example command to start the process.

```
confluence-updater update -u [email protected] -s <api-token> --fqdn your-domain.atlassian.net
```

You can use environment variables instead of parameters.

```
confluence-updater-update 0.1.0
Update a page
USAGE:
confluence-updater update [OPTIONS] --secret <secret> --user <user>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-c, --config-path <config-path> The path to the config file. [env: CU_CONFIG_PATH=] [default: ./confluence-
config.yaml]
--fqdn <fqdn> The fully qualified domain name of your Atlassian Cloud. [env: CU_FQDN=]
[default: your-domain.atlassian.net]
-s, --secret <secret> The token/secret to use. [https://id.atlassian.com/manage-profile/security/api-
tokens] [env:
CU_SECRET=ZndNxSlfTOAfuyEFv8Z61863]
-u, --user <user> Confluence user to login with [env: CU_USER=]
```

0 comments on commit 6efdc91

Please sign in to comment.