This repository has been archived on 2023-02-03. You can view files and clone it, but cannot push or open issues or pull requests.
autonomic.zone/README.md

60 lines
2.2 KiB
Markdown
Raw Normal View History

[![pipeline status](https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/badges/master/pipeline.svg)](https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/commits/master)
# autonomic-cooperative.gitlab.io
A [Jekyll] based site for the Autonomic Cooperative.
The template is based on the [spectral-jekyll-theme].
2017-10-13 20:14:28 +00:00
We use [autonomic.zone] for production and [autonomic-cooperative.gitlab.io] for staging.
[Jekyll]: https://jekyllrb.com/
[spectral-jekyll-theme]: https://github.com/andrewbanchich/spectral-jekyll-theme
2017-10-13 20:14:28 +00:00
[autonomic.zone]: https://autonomic.zone/
[autonomic-cooperative.gitlab.io]: http://autonomic-cooperative.gitlab.io/
2017-10-04 14:07:32 +00:00
# Contribute
2017-10-04 14:07:32 +00:00
Please see [CONTRIBUTING.md] for the juicy details.
2017-10-04 14:07:32 +00:00
[CONTRIBUTING.md]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/blob/master/CONTRIBUTING.md
2017-09-22 09:46:39 +00:00
2017-10-04 14:07:32 +00:00
# Make A New Release
2017-09-24 13:34:02 +00:00
2017-11-05 14:46:28 +00:00
Please add a new [change log] entry. This helps us track released changes easily.
2017-11-05 14:35:46 +00:00
2017-11-05 14:46:28 +00:00
[CHANGELOG.md]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/blob/master/CHANGELOG.md
Then, [tag a new commit] and send it upstream with:
[tag a new commit]: https://git-scm.com/book/en/v2/Git-Basics-Tagging
2017-11-05 14:35:46 +00:00
[semantic versioning]: http://semver.org/
2017-09-22 09:46:39 +00:00
```bash
2017-11-05 14:35:46 +00:00
$ COMMIT=$(git rev-parse HEAD)
$ TAG=6.6.6 # enter your new tag
$ git tag -a $TAG $COMMIT
2017-10-04 14:48:00 +00:00
$ git push upstream master --tags
2017-09-22 10:21:53 +00:00
```
2017-11-05 14:35:46 +00:00
You can also use the [Gitlab tags UI] for this.
2017-10-04 14:48:00 +00:00
2017-11-05 14:35:46 +00:00
[Gitlab tags UI]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/tags
Our [deploy] CI stage will push the new site to [the production branch].
[deploy]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/blob/d16aec42bd2ddd7449f55d9f06b03499cc660b22/.gitlab-ci.yml#L17
[the production branch]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/tree/production
Watch the [CI/CD pipeline] to see that it builds successfully.
[CI/CD pipeline]: https://gitlab.com/autonomic-cooperative/autonomic-cooperative.gitlab.io/pipelines
Then head over to [fullyautomatedluxuryinfrastructure] and run:
[fullyautomatedluxuryinfrastructure]: https://gitlab.com/autonomic-cooperative/fullyautomatedluxuryinfrastructure
``` bash
$ ansible-playbook orgs/autonomic/gitlabpages.yml
2017-10-04 14:48:00 +00:00
```