This document describes the installation process of Coder for the INF110 labs on the R2 OpenStack cluster.
It should be possible to adapt this to other use cases or OpenStack clusters with minor modifications.
This document describes the installation process of Coder for the INF110 labs on the R2 OpenStack.
It should be possible to adapt this to other use cases or OpenStack instances with minor modifications.
### Prerequisites
We will need an OpenStack project, an `openrc` file, and the OpenStack CLI tools. The CLI tools are available in the `nix develop` environment.
```bash
source openrc # automatically done by the nix env if you have this file
```
The project should have a Fedora CoreOS image available.
```bash
openstack image list
```
If not, it can be created using the following command (after downloading the image from the [Fedora CoreOS website](https://builds.coreos.fedoraproject.org/prod/streams/stable/builds/38.20230806.3.0/x86_64/fedora-coreos-38.20230806.3.0-openstack.x86_64.qcow2.xz)):
It can happen that the cluster creation hangs. In that case, log in to the master node and check if it reports that the `etcd` service failed. If so, restart the `etcd` service and the cluster creation should continue.
You can follow the cluster creation process using the "Orchestration > Stacks" section of the OpenStack dashboard or using the CLI:
```bash
openstack coe cluster show inf110
```
It can happen that the cluster creation hangs during the step of creating the master node. In that case, try associating a public IP to the master node. If it still doesn't resolve the problem, log in to the master node and check if it reports that the `etcd` service failed. If so, restart the `etcd` service and the cluster creation should continue.
```bash
sudo systemctl restart etcd
...
...
@@ -46,7 +86,7 @@ This registry will be used to store the Docker image of the Coder workspace.