This is a template for the declarations repository of Open Terms Archive

NOTE: When creating from this template, please keep the naming structure of ${instanceName}-declarations in order to keep consistency across repos and organisations.

In order to use it, follow this simple steps:

• Navigate to https://github.com/OpenTermsArchive/template-declarations
• Click on Use this template
• Enter the name of the target repository ${instanceName}-declarations and the target organization
• Edit this file by clicking on the icon at the top right of this file (This icon is visible if you have the right to modify this repo)
• Remove this paragraph and replace the ${instanceName}
• Add any documentation you find necesary

You can also check the complete doc: How to use a template on Github

Then you need to

• Follow the instructions to Continuous Deployment
• Clone the repository you just created and named ${instanceName}-declarations
• Launch ./init.sh ${instanceName} "${instanceMaintainer}" (instanceMaintainer being the name of the entity that will maintain the declarations)
• Commit the files to git git add . && git commit -m "Initiate instance"

This will replace the corresponding variables in the files and remove the now useless files.

For continuous deployment on your server, you need to define the following variables as GitHub secrets:

• SERVER_FINGERPRINT: obtained with ssh-keyscan -H $serverAddress.
• SERVER_SSH_KEY: a private SSH key allowed to connect to your server.

You can for example generate one on your server with ssh-keygen -q -N "" -f ~/.ssh/ota-deploy && cat ~/.ssh/ota-deploy.pub >> authorized_keys, and store the contents of ~/.ssh/ota-deploy as the SERVER_SSH_KEY secret.

The code in this repository is distributed under the GNU Affero General Public Licence (AGPL) v3.0.