https://github.com/nhsdigital/simplifier-project-source-control
https://github.com/nhsdigital/simplifier-project-source-control
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/nhsdigital/simplifier-project-source-control
- Owner: NHSDigital
- Created: 2023-06-12T23:43:10.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-13T08:35:14.000Z (almost 3 years ago)
- Last Synced: 2025-04-09T09:44:28.578Z (11 months ago)
- Size: 22.4 MB
- Stars: 0
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Simplifier Project Source Control
A simple repo that can be forked and configured to download, unpack, commit, create a PR and merge the current state of a Simplifier project.
## Prequsites
A valid Simplifier account.
## Enable actions
The action is disabled in this repo, so must be enabled. Additionally, when forking a repo, even if an action is enabled in the original repo, it may be necessary to enable actions to run as they are by default set to disabled on fork. See the github docs on [forking settings](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#controlling-changes-from-forks-to-workflows-in-public-repositories) in regards to actions, and [enabling/disabling](https://docs.github.com/en/actions/managing-workflow-runs/disabling-and-enabling-a-workflow) workflows for more details.
## Schedule to run
The action is set to run hourly by default in the [action file](.github/workflows/backup.yml#L6).
Further info on using a [scheduled cron job](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#schedule) in an action.
## Respository secrets required
Docs on [creating secrets for a respository](https://docs.github.com/en/actions/security-guides/encrypted-secrets#creating-encrypted-secrets-for-a-repository).
### Secrets to add:
* REPO_TOKEN
* A GitHub token that has privileges to create branches, commit to branches, use workflows and create PR's.
* See GitHub docs on [using PAT tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)
* COMITTER
* User to commit as.
* SIMPLIFIER_USER
* Simplifier user that has access to project.
* SIMPLIFIER_PWD
* Password for Simplifier user.
## Respository variables required
Docs on [creating variables for a respository](https://docs.github.com/en/actions/learn-github-actions/variables#creating-configuration-variables-for-a-repository).
### Variables to add:
* COMITTER_NAME
* Name of user to commit as.
* SIMPLIFIER_ADDRESS
* Address of project - e.g. `https://api.simplifier.net//zip`
* See Firely docs on project zip using the [Simplifier API](https://docs.fire.ly/projects/Simplifier/features/api.html#project-zip-api)
## Configure branches to delete automatically
The action will create and merge a PR into main. To automatically delete the head branch when the PR is merged, see [GitHub docs](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-the-automatic-deletion-of-branches)
Updated at: Tue Jun 13 08:12:44 UTC 2023