testnet-ops/service-provider-setup

service-provider-setup

Setup Ansible

To get started, follow the installation guide to setup ansible on your machine

Configure DNS

Prerequisites

• Buy a domain and configure nameservers to DigitalOcean

• Generate a DigitalOcean access token

Create DNS entries in DigitalOcean

• Copy the dns-vars.example.yml file

  cd vars/
  cp dns-vars.example.yml dns-vars.yml
  

• Set the following values in the dns-vars.yml file

  # primary domain for which DNS records will be managed
  # eg: laconic.com
  domain: ""
  
  # specific prefix for subdomains
  # eg: lcn-cad
  subdomain_prefix: ""
  
  # The IP address to be used for the A record of the cluster control machine
  # eg: 23.111.78.179
  cluster_control_ip: ""
  
  # DigitalOcean access token
  # eg: dop_v1...
  do_api_token: ""
  

• Run the setup-dns.yml ansible playbook to create the necessary DNS entries in DigitalOcean

  ansible-playbook setup-dns.yml
  

Setup User dev

• Create a new hosts.ini file:

  cp ../hosts.example.ini hosts.ini
  

• Edit the hosts.ini file to run the playbook on a remote machine:

  [deployment_host]
  <host_name> ansible_host=<target_ip> ansible_user=<ssh_user> ansible_ssh_common_args='-o ForwardAgent=yes'
  

  • Replace <host_name> with the desired hostname of the remote machine
  • Replace <target_ip> with the IP address or hostname of the target machine
  • Replace <ssh_user> with root

• Verify that you are able to connect to the host using the following command:

  ansible all -m ping -i hosts.ini -k
  
  # Expected output:
  
  # <host_name> | SUCCESS => {
  #  "ansible_facts": {
  #      "discovered_interpreter_python": "/usr/bin/python3.10"
  #  },
  #  "changed": false,
  #  "ping": "pong"
  # }
  

• Execute the setup-user.yml Ansible playbook to create a user dev with sudo permissions:

  ansible-playbook setup-user.yml -i hosts.ini --extra-vars='{ "target_host": "deployment_host" }'