forked from toolshed/docs.coopcloud.tech
Compare commits
1 Commits
dev
...
beta-relea
Author | SHA1 | Date | |
---|---|---|---|
4ee537f690
|
@ -1,4 +1,4 @@
|
||||
FROM squidfunk/mkdocs-material:8.3.0
|
||||
FROM squidfunk/mkdocs-material:8.2.16
|
||||
|
||||
EXPOSE 8000
|
||||
|
||||
|
@ -32,15 +32,15 @@ If there's no official release for the architecture you use, you can cross-compi
|
||||
|
||||
## Release management
|
||||
|
||||
We use [goreleaser](https://goreleaser.com) to help us automate releases. We use [semver](https://semver.org) for versioning all releases of the tool. While we are still in the public alpha release phase, we will maintain a `0.y.z-alpha` format. Change logs are generated from our commit logs. We are still working this out and aim to refine our release praxis as we go.
|
||||
We use [goreleaser](https://goreleaser.com) to help us automate releases. We use [semver](https://semver.org) for versioning all releases of the tool. While we are still in the public beta release phase, we will maintain a `0.y.z-beta` format. Change logs are generated from our commit logs. We are still working this out and aim to refine our release praxis as we go.
|
||||
|
||||
For developers, while using this `-alpha` format, the `y` part is the "major" version part. So, if you make breaking changes, you increment that and _not_ the `x` part. So, if you're on `0.1.0-alpha`, then you'd go to `0.1.1-alpha` for a backwards compatible change and `0.2.0-alpha` for a backwards incompatible change.
|
||||
For developers, while using this `-beta` format, the `y` part is the "major" version part. So, if you make breaking changes, you increment that and _not_ the `x` part. So, if you're on `0.1.0-beta`, then you'd go to `0.1.1-beta` for a backwards compatible change and `0.2.0-beta` for a backwards incompatible change.
|
||||
|
||||
### Making a new release
|
||||
|
||||
- Change `ABRA_VERSION` to match the new tag in [`scripts`](./scripts/installer/installer) (use [semver](https://semver.org))
|
||||
- Commit that change (e.g. `git commit -m 'chore: publish next tag x.y.z-alpha'`)
|
||||
- Make a new tag (e.g. `git tag -a x.y.z-alpha`)
|
||||
- Commit that change (e.g. `git commit -m 'chore: publish next tag x.y.z-beta'`)
|
||||
- Make a new tag (e.g. `git tag -a x.y.z-beta`)
|
||||
- Push the new tag (e.g. `git push && git push --tags`)
|
||||
- Wait until the build finishes on [build.coopcloud.tech](https://build.coopcloud.tech/coop-cloud/abra)
|
||||
- Deploy the new installer script (e.g. `cd ./scripts/installer && make`)
|
||||
|
@ -16,7 +16,7 @@ We'd be happy to hear feedback about our documentation, if it was helpful, what
|
||||
|
||||
!!! danger "Here be dragons"
|
||||
|
||||
This project is still [alpha quality software](https://en.wikipedia.org/wiki/Software_release_life_cycle#Alpha) :bomb: Please take that into consideration if you are thinking about using this system in production. We're working hard to make Co-op Cloud stable. In the meantime, this is a good time to help us out with initial testing, feedback, ideas or [join in with development](/get-involved/).
|
||||
This project is still [beta quality software](https://en.wikipedia.org/wiki/Software_release_life_cycle#Beta) :bomb: Please take that into consideration if you are thinking about using this system in production. We're working hard to make Co-op Cloud stable. In the meantime, this is a good time to help us out with initial testing, feedback, ideas or [join in with development](/get-involved/).
|
||||
|
||||
- [Operators guide](/operators/): You run a Co-op Cloud deployment or want to do so :computer:
|
||||
|
||||
|
@ -2,8 +2,8 @@
|
||||
title: Bike map
|
||||
---
|
||||
|
||||
- The project is currently in an [alpha quality](https://en.wikipedia.org/wiki/Software_release_life_cycle#Alpha) release state.
|
||||
- The project is currently in a [beta quality](https://en.wikipedia.org/wiki/Software_release_life_cycle#Beta) release state.
|
||||
|
||||
- We are working towards a [beta release](https://en.wikipedia.org/wiki/Software_release_life_cycle#Beta). Our public Beta goals are listed in the following pad: [Beta Bike Map](https://pad.autonomic.zone/s/C3uuqfSCk).
|
||||
- We are working towards a stable `1.0.0` release.
|
||||
|
||||
- What we're currently working on is listed on this issue tracker: [`coop-cloud/organising`](https://git.autonomic.zone/coop-cloud/organising/issues).
|
||||
|
@ -9,5 +9,5 @@ Special thanks to:
|
||||
- [Doop Coop](mailto:cluck@doop.coop), for making a transparent version of the Co-op Cloud logo, and helping with OSX alpha testing.
|
||||
- [Social.coop](https://social.coop), for warmly welcoming us onto [`social.coop/@coopcloud`](https://social.coop/@coopcloud).
|
||||
- [Servers.coop](https://servers.coop), for hosting our digital infrastructure (website, builds, git hosting, etc.).
|
||||
- Every single last one of you heroic & patient alpha/beta testers, you are all comrades of the highest order of kropotkin :heart:
|
||||
- Every single last one of you heroic & patient beta testers, you are all comrades of the highest order of kropotkin :heart:
|
||||
- [`egonelbre/gophers`](https://github.com/egonelbre/gophers) for the rad gopher logos
|
||||
|
@ -6,6 +6,6 @@ title: Managed hosting
|
||||
|
||||
If you're a co-operative or a tech collective who wants to appear on this list, please [get in touch](/intro/contact/)! We want to expand the number of service providers using the Co-op Cloud so that project is more widely available to end-users and organisations who can influence the direction and co-fund the development.
|
||||
|
||||
The Co-op Cloud is still [alpha quality software](https://en.wikipedia.org/wiki/Software_release_life_cycle#Alpha) :bomb: but you can still work with a tech co-op or collective to host some part or all of your online digital services with it. Organisations who want to support the project can get in touch with Co-op Cloud service providers via the following list for a quote on what they're looking for and how much it will cost. Service providers can then factor in some percentage of the cost to co-fund the development of this project.
|
||||
The Co-op Cloud is still [beta quality software](https://en.wikipedia.org/wiki/Software_release_life_cycle#Beta) :bomb: but you can still work with a tech co-op or collective to host some part or all of your online digital services with it. Organisations who want to support the project can get in touch with Co-op Cloud service providers via the following list for a quote on what they're looking for and how much it will cost. Service providers can then factor in some percentage of the cost to co-fund the development of this project.
|
||||
|
||||
- [Autonomic Co-op](https://autonomic.zone) (contact: [`helo@autonomic.zone`](mailto:helo@autonomic.zone))
|
||||
|
@ -116,16 +116,6 @@ docker swarm init
|
||||
docker network create -d overlay proxy
|
||||
```
|
||||
|
||||
alternatively, if you want to provision your server with abra, instead of manually installing docker:
|
||||
```
|
||||
# add your user to sudo group
|
||||
usermod -aG sudo $YOURUSERNAME
|
||||
|
||||
# install ssh-askpass
|
||||
sudo apt update && sudo apt install ssh-askpass
|
||||
|
||||
```
|
||||
|
||||
!!! question "Do you support multiple web proxies?"
|
||||
|
||||
We do not know if it is feasible and convenient to set things up on an existing server with another web proxy which uses ports `:80` & `:443`. We'd happily receive reports and documentation on how to do this if you manage to set it up!
|
||||
@ -147,10 +137,6 @@ Where `116.203.211.204` can be replaced with the IP address of your server.
|
||||
|
||||
### Command-line setup
|
||||
|
||||
#### Dependencies
|
||||
|
||||
You need to have Docker running on your local machine, and the user you're running abra from must have permission to control Docker. If you're having trouble, try adding yourself to the `docker` group, and re-logging.
|
||||
|
||||
#### Install `abra`
|
||||
|
||||
Now we can install [`abra`](/abra) locally on your machine and hook it up to your server.
|
||||
@ -179,13 +165,11 @@ If you run into issues during installation, [please report a ticket](https://git
|
||||
Now you can connect `abra` with your server. You need to have a working SSH configuration before you can do this. That means you can run `ssh <server-domain>` on your command-line and everything Works :tm:.
|
||||
|
||||
```bash
|
||||
abra server add <server-domain> -p -a
|
||||
abra server add <server-domain> -p
|
||||
```
|
||||
|
||||
The `-p` or `--provision` flag means that `abra` will install Docker and initialise the [new single-host swarm](https://docs.docker.com/engine/swarm/key-concepts/) on your server. If you've already followed the steps in [the server setup](/operators/tutorial/#server-setup) step, then `abra` should not need to do any work.
|
||||
|
||||
The `-a` or `--ask-sudo-pass` flag means that abra will use `ssh-askpass` on your server to ask for sudo pass. Skip if you have passwordless sudo on your server or if logging in as root.
|
||||
|
||||
It is important to note that `<domain>` here is a publicy accessible domain name which points to your server IP address. `abra` does make sure this is the case and this is done to avoid issues with HTTPS certificate rate limiting.
|
||||
|
||||
You will now have a new `~/.abra/` folder on your local file system which stores all the configuration of your Co-op Cloud instance.
|
||||
|
@ -1,4 +1,4 @@
|
||||
mkdocs-awesome-pages-plugin==2.7.0
|
||||
mkdocs-material-extensions==1.0.3
|
||||
mkdocs-material==8.3.0
|
||||
mkdocs-material==8.2.16
|
||||
mkdocs==1.3.0
|
||||
|
Reference in New Issue
Block a user