From 6a16f27f83b113debba12ac25f3e12f6ccdc5df8 Mon Sep 17 00:00:00 2001 From: jebba Date: Wed, 22 Dec 2021 11:57:50 -0700 Subject: [PATCH] create instance --- README-install.md | 89 +++++++++++++++++++++++++++++++++-------------- 1 file changed, 63 insertions(+), 26 deletions(-) diff --git a/README-install.md b/README-install.md index c2e8c25..c3ee3e2 100644 --- a/README-install.md +++ b/README-install.md @@ -1,12 +1,12 @@ # HOWTO Set up Your Own Chess Server This document shows how to install a chess server. -The free software application Lila, written by the developers at -lichess.org will be used. +The free software application Lila, written by the fine developers at +https://lichess.org, will be used. # Overview -Lila is the main component. - -System will be built from these main parts: +System will be built from these main parts listed below. You don't +need to know all of these, but knowing some system administration +will help. * OVH ISP. @@ -22,6 +22,8 @@ System will be built from these main parts: * Redis. +* Scala. + * Java. * SBT. @@ -38,7 +40,7 @@ System will be built from these main parts: * DNS. -* All the way down to Grub and below... +* All the way down to GRUB and below... # Upstream The best current upstream document describing the process is here: @@ -48,7 +50,7 @@ https://github.com/ornicar/lila/wiki/Lichess-Development-Onboarding Main upstream repos: * https://github.com/ornicar/lila - +* https://github.com/ornicar/lila-ws # Pre-Installation Setup First, you need to have a location to host the server. You will want a server @@ -61,14 +63,6 @@ that lichess.org uses. You will also need a domain and someone providing domain name service (DNS). OVH provides this service (presumably?) or I recommend Njalla. -* https://njal.la/ - -## Register at ISP -Go to OVH (or ISP of your choice) and create an account. -They may have regional websites as well: - -* https://ovh.com/ - ## Register DNS Since it takes awhile to spread across the Internet, it is best to first register your domain so that process can happen in the background while @@ -76,6 +70,16 @@ you are setting up the server. For this example, we'll use the domain `mychestserver.org`. +Go to your registrar, and register your domain, such as: + +* https://njal.la/ + +## Register at ISP +Go to OVH (or ISP of your choice) and create an account to host your server. +OVH may have regional websites as well: + +* https://ovh.com/ + ## Set up Workstation SSH Keys To connect to the server, you will need SSH keys. They'll be needed at time of server creation, so we'll make them now. This is an example how to create @@ -114,32 +118,65 @@ The key's randomart image is: ``` ## Upload SSH key to ISP +Take SSH the key you just created above and upload it to OVH. +Go to `Public Cloud`, then near the bottom left column, under +`Project Management` click `SSH Keys`. +Under the new `SSH Keys` window, click `Add and SSH Key` button. +Paste the PUBLIC key created above into the `Key` section of the +`Add an SSH key` popup window. + +Take this output and paste into that form in the browser: + +``` +cat /home/debian/.ssh/id_ecdsa-chess.pub +``` + +It should look like a tangled mess like this (note, the `debian@workstation` field +at the end is informational and can be something depending on your user/workstaion): + +``` +ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBC16EdTLECoLqSnmM/aSKrskLYN5ygu2dVvSAfiu4SAHPElrY6wqgUq6kzzsbbnko+VqyGzZ4tTWMml/AlBrQaw= debian@workstation +``` + +In the `Name` field, enter `mychestkey`. + +Click `Add` to save the key at OVH. You should now see it in the list. ## Create Virtual Machine at ISP -OVH sells dedicated "bare metal" servers called the "Bare Metal Cloud". -They also sell virtual machine instances under the "Public Cloud". +OVH sells dedicated "bare metal" servers called the `Bare Metal Cloud`. +They also sell virtual machine instances under the `Public Cloud`. The bare metal servers can be better, but they are generally more expensive, a bit more complex to set up and maintain. So for this example, we -will set up a virtual machine in the "Public Cloud". +will set up a virtual machine in the `Public Cloud`. -In OVH dashboard click on "Public Cloud", then in left column near the top -under "Compute", click "Instances". Then under the new "Instances" window, -click "Create an Instance". +In OVH `Dashboard` click on `Public Cloud`, then in left column near the top +under `Compute`, click `Instances". Then under the new `Instances` window, +click `Create an Instance`. -* Select a Model: "Discovery" tab, then select D2-8. There are some options +* `Select a Model`: `Discovery` tab, then select D2-8. There are some options with 4 gigs of RAM and fewer CPUs, which could be used, but kind of slow. This option is ~$20USD/month. -* Select a Region: The lichess.org server is in various data centers around +* `Select a Region`: The https://lichess.org server is in various data centers around Norther France, such as Gravelines (GRA). If you want to be close to that for some reason, you can select that. Or you could select a server that is regionally close to you and your users in another part of the world. -For this example, we'll select Gravelines GRA3. +For this example, we'll select Gravelines GRA3. Click `Next`. -* Select an Image: Under "Unix Distributions" tab, select "Debian 11". +* `Select an Image`: Under `Unix Distributions` tab, select `Debian 11`. -* +* `Select an Image`: Under `SSH key` at the bottom of the section, select the +`mychestkey` you created and uploaded above. Click `Next` + +* `Configure your instance`: Just one instance. We'll use `mychestserver` for +the name, use yours as appropriate. We won't do any of `Post-installation +script`, `Private Networks`, or `Backups`, although they could be used. +Click `Next`. + +* `Billing Period`: As you like. This is just a test, so here just using +`Hourly` at $0.03886/hour. Click `Create an instance` to create the +virtual computer, which also starts billing. # Installation