Minor changes to markdown files
This commit is contained in:
parent
030734f351
commit
fe9f092533
|
@ -1,5 +1,5 @@
|
||||||
# Add the Traefik App to Your Capsul:
|
# Add the Traefik App to Your Capsul:
|
||||||
1. Add app to server
|
1. Add the Traefik app to the server
|
||||||
![Add traefik app to server](../res/traefik/03.png "Add traefik app to server")
|
![Add traefik app to server](../res/traefik/03.png "Add traefik app to server")
|
||||||
|
|
||||||
2. Open Traefik's configuration file:
|
2. Open Traefik's configuration file:
|
||||||
|
|
|
@ -11,6 +11,6 @@
|
||||||
The email message contains an authorization link to your new account on yolo.servers.coop. Click the link, or copy and paste it into your browser's address bar.
|
The email message contains an authorization link to your new account on yolo.servers.coop. Click the link, or copy and paste it into your browser's address bar.
|
||||||
![click link in email](../res/coop-cloud-acct/05-email-click-this.png "click link in email message")
|
![click link in email](../res/coop-cloud-acct/05-email-click-this.png "click link in email message")
|
||||||
|
|
||||||
When the browser opens a page with your email address in the upper right corner, you have created an account with yolol.servers.coop.
|
When the browser opens a page with your email address in the upper right corner, you have created an account with yolo.servers.coop.
|
||||||
|
|
||||||
| [Next](upload-pub-key.md) | [Top](../README.md) |
|
| [Next](upload-pub-key.md) | [Top](../README.md) |
|
||||||
|
|
|
@ -9,10 +9,16 @@
|
||||||
|
|
||||||
# Add *user* to the *docker* Group
|
# Add *user* to the *docker* Group
|
||||||
|
|
||||||
After installing docker on your capsule, use *sudo usermod* command to add *user* to the *docker* group. Be sure to logout for this change to take effect. When you ssh back into the capsul, the *id* command shows which groups *user* is in.
|
After installing docker on your capsule, use *sudo usermod* command to add *user* to the *docker* group.
|
||||||
|
|
||||||
|
![13](../res/install-docker-capsul/13.png)
|
||||||
|
|
||||||
|
Be sure to logout for this change to take effect.
|
||||||
|
|
||||||
![13](../res/install-docker-capsul/13.png)
|
|
||||||
![14](../res/install-docker-capsul/14.png)
|
![14](../res/install-docker-capsul/14.png)
|
||||||
|
|
||||||
|
When you ssh back into the capsul, the *id* command shows which groups *user* is in.
|
||||||
|
|
||||||
![15](../res/install-docker-capsul/15.png)
|
![15](../res/install-docker-capsul/15.png)
|
||||||
|
|
||||||
After installing docker on the capsule and confirming that *user* is in the *docker* group, continue to the next step.
|
After installing docker on the capsule and confirming that *user* is in the *docker* group, continue to the next step.
|
||||||
|
|
|
@ -22,7 +22,7 @@ If you live your computing life on the bleeding edge, you can get a preview of W
|
||||||
## Lets Do It!!!
|
## Lets Do It!!!
|
||||||
Without further ado, let's get WSL2 installed on Windows 10! This guide is following the instructions from this page: [Windows Subsystem for Linux Installation Guide for Windows 10](https://docs.microsoft.com/en-us/windows/wsl/install-win10)
|
Without further ado, let's get WSL2 installed on Windows 10! This guide is following the instructions from this page: [Windows Subsystem for Linux Installation Guide for Windows 10](https://docs.microsoft.com/en-us/windows/wsl/install-win10)
|
||||||
|
|
||||||
There are two options available for install, simplified and manual. This guide goes through the six manual steps. **Note:** If you run into problems, there's a [troubleshooting](https://docs.microsoft.com/en-us/windows/wsl/install-win10#troubleshooting-installation) section at the bottom of the page. ![01](../res/install-wsl2-linux/01.png "01")
|
There are two options available for install, simplified and manual. This guide goes through the six manual steps. **Note:** If you run into problems, there's a [troubleshooting](https://docs.microsoft.com/en-us/windows/wsl/install-win10#troubleshooting-installation) section at the bottom of the Microsoft WSL installation page. ![01](../res/install-wsl2-linux/01.png "01")
|
||||||
|
|
||||||
1. The first step (of six) is to enable the "Windows Subsystem for Linux" feature, aka the Microsoft-Windows-Subsystem-Linux feature. Open an Administrator PowerShell window and run the dism.exe command as shown. Do **NOT** restart your computer yet.
|
1. The first step (of six) is to enable the "Windows Subsystem for Linux" feature, aka the Microsoft-Windows-Subsystem-Linux feature. Open an Administrator PowerShell window and run the dism.exe command as shown. Do **NOT** restart your computer yet.
|
||||||
|
|
||||||
|
@ -80,12 +80,14 @@ After saving the .msi file to disk, find the downloaded file in File Explorer. D
|
||||||
> wsl --list --online
|
> wsl --list --online
|
||||||
|
|
||||||
![18](../res/install-wsl2-linux/18.png "18")
|
![18](../res/install-wsl2-linux/18.png "18")
|
||||||
|
|
||||||
Pick which Linux distribution you want to install, and either click one of the links on Microsoft's web page, or do a search in the Microsoft Store.
|
Pick which Linux distribution you want to install, and either click one of the links on Microsoft's web page, or do a search in the Microsoft Store.
|
||||||
|
|
||||||
When you've found your distro in the store, you first need to click the *Get* button and then the *Launch* button.
|
When you've found your distro in the store, you first need to click the *Get* button and then the *Launch* button.
|
||||||
|
|
||||||
If you see a popup window like this, you can close it. You don't need a Windows account to get and install Linux distros from the Microsoft Store.
|
If you see a popup window like this, you can close it. You don't need a Windows account to get and install Linux distros from the Microsoft Store.
|
||||||
![19](../res/install-wsl2-linux/19.png "19")
|
![19](../res/install-wsl2-linux/19.png "19")
|
||||||
|
|
||||||
Here's the Debian distro in the store. I've already gotten it once before, so I don't see the *Get* button. I just need to install and launch it.:
|
Here's the Debian distro in the store. I've already gotten it once before, so I don't see the *Get* button. I just need to install and launch it.:
|
||||||
![20](../res/install-wsl2-linux/20.png "20")
|
![20](../res/install-wsl2-linux/20.png "20")
|
||||||
![21](../res/install-wsl2-linux/21.png "21")
|
![21](../res/install-wsl2-linux/21.png "21")
|
||||||
|
|
|
@ -1,3 +1,5 @@
|
||||||
|
# Connect a Domain Name with Capsul's IP-Address
|
||||||
|
|
||||||
Your Capsul needs a hostname, also known as a domain name. There are many services which provide domain names, such as [Gandi](https://www.gandi.net) and many more. You need to register a domain name, and then set up DNS records to connect your domain name with the IPv4 address assigned to your Capsul when you created it.
|
Your Capsul needs a hostname, also known as a domain name. There are many services which provide domain names, such as [Gandi](https://www.gandi.net) and many more. You need to register a domain name, and then set up DNS records to connect your domain name with the IPv4 address assigned to your Capsul when you created it.
|
||||||
|
|
||||||
Each domain registrar has a different user interface for managing DNS records. Set up three 'A' records. One for the domain itself, one for www.your-domain-name, and one for subdomains of the domain. It will look something like this:
|
Each domain registrar has a different user interface for managing DNS records. Set up three 'A' records. One for the domain itself, one for www.your-domain-name, and one for subdomains of the domain. It will look something like this:
|
||||||
|
|
|
@ -4,13 +4,13 @@ First, add your server to abra. Change *your-domain-name* to your capsul's DNS n
|
||||||
|
|
||||||
> abra server add your-domain-name user
|
> abra server add your-domain-name user
|
||||||
|
|
||||||
![Add server to Abra](..\res\create-init-context\01.png "Add server to Abra")
|
![Add server to Abra](../res/create-init-context\01.png "Add server to Abra")
|
||||||
|
|
||||||
Next, after creating the server, initialize the docker swarm.
|
Next, after creating the server, initialize the docker swarm.
|
||||||
|
|
||||||
> abra server your-domain-name init
|
> abra server your-domain-name init
|
||||||
|
|
||||||
![Initialize docker swarm for server](..\res\create-init-context\02.png "Initialize docker swarm for server")
|
![Initialize docker swarm for server](../res/create-init-context\02.png "Initialize docker swarm for server")
|
||||||
|
|
||||||
The next step is to install Traefik.
|
The next step is to install Traefik.
|
||||||
|
|
||||||
|
|
|
@ -9,9 +9,10 @@ Previously, we logged into the remote capsule using ssh in a Windows cmd.exe win
|
||||||
|
|
||||||
> cd ~/.ssh
|
> cd ~/.ssh
|
||||||
|
|
||||||
1. Copy your keys from your Windows .ssh directory into the Linux .ssh directory using the cp command and the Windows C: drive being mounted at /mnt/c. Assuming your Windows user name is *user*. Verify that both parts of your key have been copied into the Linux ~/.ssh folder with the *ls* command.
|
1. Copy your keys from your Windows .ssh directory into the Linux .ssh directory using the cp command. In the Linux Debian system, /mnt/c corresponds to c:\ in the Windows system. Let's assume your Windows user name is *user*. Use *ls* command to verify that both parts of your key have been copied into the Linux ~/.ssh folder.
|
||||||
|
|
||||||
> cp /mnt/c/users/user/.ssh/id_rsa* .
|
> cp /mnt/c/users/user/.ssh/id_rsa* .
|
||||||
|
> ls ~/.ssh
|
||||||
|
|
||||||
You should see two files, id_rsa and id_rsa.pub
|
You should see two files, id_rsa and id_rsa.pub
|
||||||
|
|
||||||
|
@ -41,7 +42,7 @@ Previously, we logged into the remote capsule using ssh in a Windows cmd.exe win
|
||||||
> ssh user@capsul-domain-name
|
> ssh user@capsul-domain-name
|
||||||
![run ssh again using domain name instead of ip address](../res/wsl-ssh-to-capsul/05.png "run ssh again using domain name instead of ip address")
|
![run ssh again using domain name instead of ip address](../res/wsl-ssh-to-capsul/05.png "run ssh again using domain name instead of ip address")
|
||||||
|
|
||||||
1. Again, compare the fingerprint of the ssh command with the fingerprint in the capsul-fingerprints file. If they match, type *yes* and Enter. This causes the domain name to be added to the list of known hosts.
|
1. Again, compare the fingerprint of the ssh command with the fingerprint in the capsul-fingerprints file. If they match, type *yes* and Enter. This causes the domain name to be added to the list of known hosts in Linux.
|
||||||
|
|
||||||
1. Close the ssh connection to your remote capsule.
|
1. Close the ssh connection to your remote capsule.
|
||||||
|
|
||||||
|
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
There is no front-end to your capsul. All access to it will be remote, for example, with *ssh*. You need to create SSH keys and upload your public key to your account before you can create a capsul.
|
There is no front-end to your capsul. All access to it will be remote, for example, with *ssh*. You need to create SSH keys and upload your public key to your account before you can create a capsul.
|
||||||
|
|
||||||
This guide explains how to create SSH Keys on your local Windows computer. The steps describe using Window's built-in OpenSSH feature. If you prefer [PuTTY](https://en.wikipedia.org/wiki/PuTTY), you can skip these steps and use that instead.
|
This guide explains how to create SSH Keys on your local Windows computer. The steps describe using Window's built-in OpenSSH feature. If you prefer [PuTTY](https://en.wikipedia.org/wiki/PuTTY), you can skip to step 5.
|
||||||
|
|
||||||
1. Open an Administrator PowerShell window.
|
1. Open an Administrator PowerShell window.
|
||||||
![open administrator powershell on windows](../res/upload-pub-key/08-win-admin-power-shell.png)
|
![open administrator powershell on windows](../res/upload-pub-key/08-win-admin-power-shell.png)
|
||||||
|
|
Loading…
Reference in New Issue