Internal Errigal Collaboration Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== How to deploy a new version ======

===== Before anything, ensure that docker is installed on the servers where agents are to be run. We have a playbook for this in server-confguration, which can be run via: =====

<code>
ansible-playbook install-docker.yml -i ../env-configuration/qanova/hosts.ini --diff --vault-id @prompt --limit=rdfagent
</code>

1. After you've done making your changes to the code, commit and push your changes. The jenkins will build your artifact and push to our registery.errigal.com docker registry. You can access docker.errigal.com to view other available versions.

2. Ensure that the servers containing the agent are in appropriate groups in the Ansible inventory file, like so:

<code>
[rdfagent]
qanovaoat1 
qanovaoat2
</code>

Any properties used by rdfagent can be specified via the rdf_agent_env_vars map. Here is an example for airscan rdfagents:

<code>
[airscan:vars]
[rdf_agent_env_vars]
TASK_WORKERS=1
MODEM_MANAGER_URL=http://host.docker.internal:5000
NODE_EXPORTER_URL=http://host.docker.internal:10000/metrics
PROM2JSON_PATH=/bin/prom2json
</code>

The defaults are quite sane, so this shouldn't be necessary in 99% of cases.

3. Ensure that each server/or a group if using the same agent have the correct token specified as the rdf_access_token variable:

<code>
scooat1    ansible_host=10.91.201.96 ansible_ssh_user=scotty ansible_ssh_pass={{ssh_oat1_pass}}   ansible_become_pass={{ssh_oat1_pass}} rdf_access_token="eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJXXXXiOiJyZGYiLCJleHAiOjQ4MTQ0MTcwMTIsInVzZXJJZCI6NDIsInVzZXJuYW1lIjoic2NvX2FnZW50XzEifQ.sQZ8gkIslfUcsxw15Gg5IxXXXwzfrh9x07h9m-XXXc"
</code>

4. Run the ansible command with the desired version to deploy your agent:
<code>
ansible-playbook rdf-agent-docker-deploy.yml -i ../env-configuration/qanova/hosts.ini -e version="REL-4.17.0.1" --vault-id @prompt --diff
</code>

5. To view the running container do:

<code>
docker ps
</code>

If it's not running, you can do
<code>
docker ps -a
</code>

To view logs:
<code>
docker logs <containerID/name>
</code>

To view env variables etc do:
<code>
docker inspect <containerID/name>
</code>
Sidebar

Internal Errigal Collaboration Wiki

User Tools

Site Tools

Page Tools
