diff --git a/content/pages/docs.md b/content/pages/docs.md index 6598c6b..7266cc1 100644 --- a/content/pages/docs.md +++ b/content/pages/docs.md @@ -14,3 +14,4 @@ the Ocata version). ## For administrators - [User Setup]({filename}user-setup.md) +- [Adding a New OS Image]({filename}os-image.md) diff --git a/content/pages/os-image.md b/content/pages/os-image.md new file mode 100644 index 0000000..329dd0c --- /dev/null +++ b/content/pages/os-image.md @@ -0,0 +1,49 @@ +title: Adding a New OS Image +slug: docs/admin/os-image +status: hidden + +## Adding an Ubuntu Image + +Use the daily builds for the Ubuntu Cloud Server images. These can be found +[here][ubuntu]. + +### 1. Download the target image + +On `corn-syrup.csclub.uwaterloo.ca`, download your target image. Ensure you +pick a qcow2 formatted image. These usually end in the `*.img` extension. + +For example, + +```sh +cd /tmp +wget https://cloud-images.ubuntu.com/bionic/current/bionic-server-cloudimg-amd64.img +``` + +### 2. Upload the image to OpenStack + +Note that you must have set your OpenStack environment variables correctly for +this step to work. See Appendix A below. + +Make sure to set your `$FILENAME` and `$IMAGE_NAME` variables to the location +and name of your desired image. For example, + +```sh +FILENAME="/tmp/bionic-server-cloudimg-amd64.img" +IMAGE_NAME="Ubuntu Server 18.04 LTS (Bionic Beaver) daily build" +openstack image create --container-format bare --disk-format qcow2 --file $FILENAME --public $IMAGE_NAME +``` + +### Appendix A: OpenStack Environment Variables + +```sh +export OS_USERNAME= +export OS_PROJECT_NAME=csc +export OS_USER_DOMAIN_NAME=csclub +export OS_PROJECT_DOMAIN_NAME=csclub +export OS_AUTH_URL=https://auth.cloud.csclub.uwaterloo.ca/v3 +export OS_IDENTITY_API_VERSION=3 +``` + +NOTE: To control your personal project, change `OS_PROJECT_NAME` to your username. + +[ubuntu]: https://cloud-images.ubuntu.com/