Mirrors/ansible
2
0
Fork 0
mirror of https://github.com/kasmtech/ansible synced 2024-12-04 17:19:11 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
5 commits 1 branch 0 tags 103 KiB
Shell 100%
Find a file
Ian Tangney 29acddd4bb KASM-1942 Retry Kasm Workspaces install if it fails with dpkg lock error
2021-09-16 09:35:26 -04:00
group_vars KASM-1829 Create new ansible playbook that installs Kasm Workspaces in multi server configuration. 2021-09-08 22:39:52 +00:00
roles/install_common KASM-1942 Retry Kasm Workspaces install if it fails with dpkg lock error 2021-09-16 09:35:26 -04:00
install_kasm.yml KASM-1829 Create new ansible playbook that installs Kasm Workspaces in multi server configuration. 2021-09-08 22:39:52 +00:00
inventory KASM-1829 Create new ansible playbook that installs Kasm Workspaces in multi server configuration. 2021-09-08 22:39:52 +00:00
README.md KASM-1829 Create new ansible playbook that installs Kasm Workspaces in multi server configuration. 2021-09-08 22:39:52 +00:00

README.md

Ansible

Installing Ansible

This project requires ansible 2.9.24 or greater on the host running the ansible playbook. The target systems do no not need Ansible installed.

The steps below for installing Ansible have been tested on CentOS 7.9.2009, CentOS 8.4.2105, Debian 9.13, Debian 10.10, Ubuntu 18.04.5, and Ubuntu 20.04.3.

  1. Ensure pip3 is installed

    Ubuntu/Debian: sudo apt install python3-pip

    CentOS: sudo yum install python3-pip

  2. Add local bin directory to path in bashrc

    echo 'PATH=$PATH:$HOME/.local/bin' >> ~/.bashrc
source ~/.bashrc

  3. Use pip to install ansible

    python3 -m pip install --user -U pip && python3 -m pip install --user -U ansible

  4. Ensure that ansible version is greater than 2.9.24

    ansible --version

Kasm Multi Server install

This project will deploy Kasm Workspaces in a multi-server deployment using Ansible.

  • It installs the kasm components on the systems specified in the ansible inventory required for the respective roles (db, web, agent).
  • It creates a new swapfile to ensure that the total swap space matches the size desired_swap_size specified on the files in group_vars/.
  • It enables the docker daemon to run at boot to ensure that kasm services are started after a reboot.

It has been tested on CentOS 7.9.2009, CentOS 8.4.2105, Debian 9.13, Debian 10.10, Ubuntu 18.04.5, and Ubuntu 20.04.3

Diagram

Ansible Configuration

  1. Open roles/install_common/vars/main.yml, group_vars/agent.yml and update variables if desired.

  2. Open inventory file and fill in the hostnames / ips for the servers that will be fulfilling the agent, webapp and db roles.

  3. Run the deployment.

    ansible-playbook -Kk -u [username] -i inventory install_kasm.yml

    Ansible will prompt you for the ssh password and sudo password (will almost always be the same password).

    Or, if you have ssh keys copied over to your servers and have NOPASSWD in sudoers you can just run.

    ansible-playbook -u [username] -i inventory install_kasm.yml

  4. Login to the deployment as admin@kasm.local using the IP of one of the WebApp servers (eg https://192.168.1.2)

  5. Navigate to the Agents tab, and enable each Agent after it checks in. (May take a few minutes)