Added text for 02-setup-dns-records README

This commit is contained in:
LMurphy001 2021-08-23 18:30:53 -04:00
parent 09e0be853c
commit 1be18aee69
2 changed files with 10 additions and 4 deletions

View File

@ -16,7 +16,7 @@ The email message contains an authorization link to your new account on yolo.ser
1. Back in your browser on the yolo servers website, click the *SSH & API Keys* link. There will be no front-end to your capsul. All access to it will be remote, for example, with *ssh*. You need to create SSH keys before you can create your capsul.
![open SSH & API Keys](07-yolo-ssh-public-keys.png "open SSH & API Keys")
1. Create SSH Key on your local Windows computer. This document explains how to do so using Window's built-in OpenSSH feature. If you prefer PuTTY, you can skip these steps and use that instead.
1. Create SSH Keys on your local Windows computer. This guide explains how to do so using Window's built-in OpenSSH feature. If you prefer PuTTY, you can skip these steps and use that instead.
1. Open an Administrator PowerShell window.
![open administrator powershell on windows](08-win-admin-power-shell.png "open administrator powershell on windows")
1. Use the *get-WindowsCapability* command to find out if Windows already has the OpenSSH client installed.
@ -28,7 +28,7 @@ The email message contains an authorization link to your new account on yolo.ser
1. *cd* to your home directory. In this example, the home directory is c:\users\userid.
1. Use *dir* to discover if you already have a *.ssh* subdirectory in your home directory.
1. If necessary, use *mkdir .ssh* to create the subdirectory.
1. Run *ssh-keygen.exe* to generate an SSH key pair. Press *enter* key to accept the default filename. Press *enter* key twice to skip adding a passphrase. Your key pair identification is then saved in the *.ssh* subdirectory. You will see a key fingerprint ending in your Windows username @ your Windows hostname. You'll also see the key's randomart image.
1. Run *ssh-keygen.exe* to generate an SSH key pair. Press *enter* key to accept the default filename. Press *enter* key twice to skip adding a passphrase. Your key pair identification is then saved in the *.ssh* subdirectory. You will see a key fingerprint ending in `your-Windows-username@your-Windows-hostname`. You'll also see the key's randomart image.
![create ssh key using ssh-keygen.exe](11-win-ssh-keygen.png "create ssh key using ssh-keygen.exe")
1. Launch Notepad.exe and open file *c:\users\userid\\.ssh\id_rsa.pub*. Select all of the file's contents and copy to the clipboard. ![copy public ssh key to clipboard using notepad.exe](12-win-notepad-cp-pub-ssh-key.png "copy public ssh key to clipboard using notepad.exe")
@ -47,7 +47,7 @@ The email message contains an authorization link to your new account on yolo.ser
1. Click the *Capsuls* link, and the *Create one!* link. This will open the **CREATE CAPSUL** page.
1. You will see your *account balance*
1. Pick a Capsul Size from the drop-down box. This screenshot shows size *f1-xs* selected.
1. Leave *Debian 10 (Buster)* as the operating system; it's the only one availabe for Capsuls at this time.
1. Leave *Debian 10 (Buster)* as the operating system; it's the only one available for Capsuls at this time.
1. Put a check mark in the box next to the name of your public SSH key. In this screenshot, it's named *user-name@host-name*.
1. Click on the *Create* button.
1. Wait for your Capsul to be created and initialized.
@ -60,7 +60,7 @@ The email message contains an authorization link to your new account on yolo.ser
1. Remotely login to your new Capsul using ssh.
1. Open a cmd.exe window
1. Run ssh command. The name of the Linux user on the Capsul is **user**. You'll use the IPv4 address from the previous step. In this guide, the Capsul's address is *148.251.164.88*.
1. Run ssh command. The name of the Linux user on the Capsul is **user**. You'll use the IPv4 address from a previous step.
1. When you run the ssh command, you'll see a line saying the authenticity of the host can't be established. It will show you the key fingerprint.
1. Use the mouse to copy the fingerprint string to the clipboard
1. Open the Capsul fingerprints text file you saved in the previous step.

View File

@ -1,3 +1,9 @@
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 for 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. It will look something like this:
![set up dns records](01-setup-dns-records.png "set up dns records")
**Be sure to remove CNAME and ALIAS records.** After you save your updated DNS records, you can verify they've been propagated with the [DNS Checker](https://dnschecker.org/) website.
![check dns propagation](02-check-dns-propagation.png "check dns propagation")