Server provisioning

Installation

Prerequisites

1. An Ubuntu 20.04 (LTS) server with root access
2. A domain name resolved to the server's IP-address

Provisioning

Login to your server as root and execute the following commands line-by-line.

1. Get the provisioning script and execute it:

# This will create a new user `vyva` and the SSH key if run as root.
bash <(wget -qO- https://raw.githubusercontent.com/fivejars/vyva/master/provision.sh)

The user will be used to run all further commands.

Jenkins will use that user to execute all its jobs.

The key will be needed when Jenkins Worker will be configured.

2. Docker installation

# When you are asked to switch to user 'vyva' do the following:
su - vyva
# As vyva, execute the provisioning script once again.
bash <(wget -qO- https://raw.githubusercontent.com/fivejars/vyva/master/provision.sh)
# Re-login when you are asked and execute the script again.
exit
su - vyva

3. Nginx, SSL, Jenkins, Puppeteer installation and provisioning.

bash <(wget -qO- https://raw.githubusercontent.com/fivejars/vyva/master/provision.sh)

During this phase you'll be asked to input the domain name and your email.

The domain is needed to properly point web-server and let the Let's Encrypt generate a free SSL certificate.

The email is needed for notifications in case of issues or changes with the generated certificate.

At the end of the script execution, you'll be provided with the Administrator Password and the link to the service.

Initial configuration

1. Navigate to the service using the link.

Input the password and submit the form.

2. You're asked to install Jenkins plugins, select "Select plugins to install"

3. Click on the "None" link above the listing and click on the Install button at the bottom of the page.

4. You're asked to Create the admin user. Fillout the form and submit it.

5. You're asked to input Jenkins URL. Verify it has been detected proprely and submit the form.

6. You're hitting the "Jenkins is ready!' page. Click on the 'Start using Jenkins' button.

7. You are redirected to the dashboard that lists the provisioned jobs. In the sidebar on the left, click on the "Manage Jenkins"

8. Find the Manage Credentials tile and click on it.

9. Find the Credentials table with one data row. The cell of the "Name" column should say "vyva". Hover over "vyva", click on the chevron, click on the "Update" link from the dropdown list.

10. On the form, find the 'Private Key' section. The key is "Concealed for Confidentiality". You have to update the key.

Click on the "Replace" button, the text form will appear. You have to copy the contents of the file that was created during the server provisioning.

11. Use the following command while logged in as root:

cat /root/.ssh/id_rsa

Select and copy the contents and past it to the key field in the form. Hit 'Save'.

12. On the dashboard, click on the "Worker" link in the list of exectors in the sidebar.

13. You are taken to the Agent Worker page. The agent is offline yet. Click on the "Launch Agent" button.

14. The log of the agent launch will start appearing. You should get "Agent successfully connected and online" if everything is alright.

---

At this point, your conversion tool server is almost ready to receive commands from Virtual Y websites.

Once you finished this basic Jenkins configuration proceed to https://github.com/fivejars/vyva/wiki/Drupal-module-installation-and-configuration