https://github.com/outerbounds/onprem-workstations-configuration

Describes how to configure on-premise machines so Outbounds onprem-workstations can run on them
https://github.com/outerbounds/onprem-workstations-configuration

Last synced: 4 days ago
JSON representation

Describes how to configure on-premise machines so Outbounds onprem-workstations can run on them

• Host: GitHub
• URL: https://github.com/outerbounds/onprem-workstations-configuration
• Owner: outerbounds
• Created: 2023-10-03T00:42:12.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-10-05T18:57:53.000Z (about 1 year ago)
• Last Synced: 2023-10-06T09:25:05.536Z (about 1 year ago)
• Homepage:
• Size: 1.95 KB
• Stars: 0
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Instructions

============

To run/deploy Ansible in order to configure an on-premise machine follow these steps:

1. Install Ansible on you local machine. You can use Homebrew or other methods document [here](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html).

1. Ensure the target in `inventory.yam` have all the nodes you would like to target. Example setup

    ```yaml

        ...

        machine_2:                      # target name

            ansible_host: 10.10.34.56   # target host ip or DNS

            ansible_user: ubuntu        # ssh username

    ```

1. Update the JWT issuer URL and expected audience variables in `playbook.yaml`

    ```yaml

        ...

        - name: ansible-role-onprem-workstations

        vars:

            outerbounds_issuer:  # This will be provided to you by Outerbounds

            outerbounds_audience:  # This will be provided to you by Outerbounds

        ...

    ```

1. Install the external Ansible roles:

    ```bash

    $ ansible-galaxy install -r requirements.yml --force

    ```

1. Ensure you have ssh access to all the target nodes in the inventory list. If so you can now deploy the playbok like:

    ```bash

    $ # to deploy to all nodes

    $ ansible-playbook -i inventory.yaml playbook.yaml

    $ # to deploy to a single target

    $ ansible-playbook -i inventory.yaml -l  playbook.yaml

    ```

Troubleshooting

===============

1. If Ansible gets stuck on the "Gather Facts" step you can try to remove the cache by deleting the `~/.ansible/` folder and rerun the playbook. You may also need to reinstall the Ansible roles using `ansible-galaxy install -r requirements.yml --force`.

2. If your local machine doesn't have nvidia drivers and would like them to be enabled as part of the same Ansible run, you and enable reboot by updating the `playbook.yaml` as shown below.

    ```yaml

    ...

    - name: nvidia_driver

      vars:

        nvidia_driver_skip_reboot: no

    ...

    ```

    **Note:** this variables is disabled in the playbook to avoid forcing a reboot.