https://github.com/lovoo/github-action-confluence-sync
Github action for syncing files with confluence pages.
https://github.com/lovoo/github-action-confluence-sync
ci-cd confluence documentation github-action markdown
Last synced: about 1 year ago
JSON representation
Github action for syncing files with confluence pages.
- Host: GitHub
- URL: https://github.com/lovoo/github-action-confluence-sync
- Owner: lovoo
- License: mit
- Created: 2020-12-15T17:13:32.000Z (over 5 years ago)
- Default Branch: develop
- Last Pushed: 2020-12-17T10:42:17.000Z (over 5 years ago)
- Last Synced: 2025-03-27T13:01:53.732Z (about 1 year ago)
- Topics: ci-cd, confluence, documentation, github-action, markdown
- Language: Python
- Homepage:
- Size: 7.81 KB
- Stars: 10
- Watchers: 28
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Confluence Markdown Sync Action
This Github Action serves the purpose of copying the contents of a Markdown `.md` file to a Confluence Cloud Page.
## Getting Started
```yml
# .github/workflows/my-workflow.yml
on: [push]
jobs:
dev:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: confluence-markdown-sync
with:
from: './README.md'
to: '123456' # The confluence page id where to write the output
cloud:
user:
token:
```
## Authentication
Uses basic auth for the rest api.
- `cloud`: The ID can be found by looking at yout confluence domain: `https://xxx.atlassian.net/...`
- `user`: The user that generated the access token
- `token`: You can generate the token [here](https://id.atlassian.com/manage-profile/security/api-tokens). Link to [Docs](https://confluence.atlassian.com/cloud/api-tokens-938839638.html)
- `to`: The page ID can be found by simply navigating to the page where you want the content to be postet to and looke at the url. It will look something like this: `https://.atlassian.net/wiki/spaces//pages//`
### Using secrets
It's **higly reccomended** that you use secrets!
To use them you need them to specify them before in your repo. [Docs](https://docs.github.com/en/free-pro-team@latest/actions/reference/encrypted-secrets)
The you can use them in any input field.
```yml
# .github/workflows/my-workflow.yml
# ...
token: ${{ secrets.token }}
```
## Development
1. Clone the repo
2. Install [act](https://github.com/nektos/act)
3. Create the same config in the repo folder as in the getting started section above.
4. Change `uses: confluence-markdown-sync` -> `uses: ./`
5. Create an example markdown file `Some.md` and set it in the config `from: './Some.md'`
6. Run locally `act -b`
### With secrets
You can simply create a `.secrets` file and specify it to `act`
```
token=abc123
```
```yml
# .github/workflows/dev.yml
# ...
token: ${{ secrets.token }}
```
```bash
act -b --secret-file .secrets
```