Skip to content

Commit

Permalink
Fix docs formatting
Browse files Browse the repository at this point in the history
RE #62
  • Loading branch information
cailafinn committed Feb 8, 2023
1 parent 7eee9f9 commit 014d859
Showing 1 changed file with 9 additions and 5 deletions.
14 changes: 9 additions & 5 deletions jenkins-node/mantid-builder-macos/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,19 +49,23 @@ The ansible scripts will set up the machine and connect it to the Jenkins contro
1. If you already have the `ansible-linode` repo and associated conda environment, activate it and skip to step 4.
2. Clone the [`mantidproject/ansible-linode`](https://github.com/mantidproject/ansible-linode) repo.
3. Navigate to the base of the cloned repo and run:
- `mamba create --prefix ./condaenv ansible`
- `mamba activate ./condaenv`
- Note: You can activate the environment from anywhere by providing the full path to the `condaenv` directory.

1. `mamba create --prefix ./condaenv ansible`
2. `mamba activate ./condaenv`
3. Note: You can activate the environment from anywhere by providing the full path to the `condaenv` directory.

4. Clone the [`dockerfiles`](https://github.com/mantidproject/dockerfiles) repo and navigate to `jenkins-node/mantid-builder-macos/ansible`.
5. Install the required collections from Ansible Galaxy by running:
- `ansible-galaxy install -r requirements.yml`
6. Time to use that secret you made a note of. Create an `inventory.txt` file with the details of the machines to deploy to (one per line):

```ini
[all]
<IP_ADDRESS_OR_HOSTNAME_1> agent_name=<NAME_OF_AGENT_ON_JENKINS_1> agent_secret=<SECRET_DISPLAYED_ON_CONNECTION_SCREEN_1>
<IP_ADDRESS_OR_HOSTNAME_2> agent_name=<NAME_OF_AGENT_ON_JENKINS_2> agent_secret=<SECRET_DISPLAYED_ON_CONNECTION_SCREEN_2>
```
If you've forgotten the secret, it can be found under `Environment Variables` in the `System Information` section of the agent.

If you've forgotten the secret, it can be found under `Environment Variables` in the `System Information` section of the agent.

### Running the Script to Deploy the Agent

Expand All @@ -73,4 +77,4 @@ ansible-playbook -i inventory.txt jenkins-agent.yml -u mantidbuilder -K

2. When prompted, enter the agent's password that you made earlier. If you weren't the one who made the password, it should be in the `ISIS Jenkins Nodes` file on Keeper.
3. Wait for the play to complete and visit `https://builds.mantidproject.org/computer/NAME_OF_AGENT_ON_JENKINS`. The agent should be connected within five minutes.
- Note: The agent is kept connected to the controller by a crontab entry that runs on every 5th minute. This means that on first setup the note may not connect until a minute divisible by five has passed.
1. Note: The agent is kept connected to the controller by a crontab entry that runs on every 5th minute. This means that on first setup the note may not connect until a minute divisible by five has passed.

0 comments on commit 014d859

Please sign in to comment.