Fitur

Role Ansible ini akan menginstal, mengonfigurasi, dan mengoperasikan proxy Snowflake standalone.

  • Mendukung Ubuntu, Debian, Arch Linux, Fedora, dan FreeBSD.
  • Unit systemd untuk mengelola layanan Snowflake pada GNU/Linux dan rc script untuk FreeBSD.

Persyaratan

  • Python
  • Ansible 2.9 atau lebih tinggi

1. Instal Ansible

Anda dapat menginstal Ansible menggunakan pip:

$ python -m pip install --user ansible

Atau temukan cara lain untuk menginstal Ansible.

2. Unduh role Ansible

Role Ansible tersebut bernama nvjacobo.snowflake. Anda dapat menemukannya di repositori Galaxy dan menginstalnya menggunakan perintah baris perintah:

$ ansible-galaxy install nvjacobo.snowflake

3. Buat playbook

Berikutnya, buat playbook Ansible untuk menjalankan role baru:

- hosts: snowflake
  roles:
      - nvjacobo.snowflake

4. Buat inventory

Inventory adalah daftar server yang akan dikelola Ansible secara otomatis melalui playbook.

[snowflake]
ip-address

5. Deploy

Terakhir, dengan menjalankan playbook, Ansible akan men-deploy proxy Snowflake standalone. Anda dapat menjalankannya sebagai root:

$ ansible-playbook -i inventory site.yml -u root

Atau dengan sudo:

$ ansible-playbook -i inventory site.yml -u username -b

6. Kelola proxy Snowflake

Jika host proxy Snowflake menjalankan systemd, Anda dapat mengelola proxy Snowflake Anda dengan menggunakan perintah systemd: start, status, dan stop. Sebagai contoh:

$ ansible all -i inventory -a 'systemctl status snowflake-proxy'

Untuk FreeBSD, Anda dapat mengelola proxy Snowflake Anda dengan menggunakan perintah rc script berikut. Sebagai contoh:

$ ansible all -i inventory -a 'service snowflake status'

7. Upgrade proxy Snowflake Anda

Penting untuk menjaga proxy Snowflake standalone Anda tetap up to date. Menjalankan playbook Ansible akan menginstal pembaruan:

$ ansible-playbook -i inventory site.yml -u root

8. (Opsional) Membatasi penggunaan

Anda dapat membatasi jumlah klien (pengguna Snowflake) dengan menggunakan variabel client. Jumlah maksimum klien bersamaan secara default tidak terbatas (0 = tidak ada batas).

Playbook di bawah ini memiliki batas 300 klien bersamaan:

- hosts: snowflake
   vars:
    clients: 300
  roles:
     - nvjacobo.snowflake

Catatan: Variabel role Ansible ini tidak tersedia untuk FreeBSD.