readme update

This commit is contained in:
marito 2025-06-10 15:34:15 +08:00
parent c65b767a5c
commit f114d214ba

View File

@ -9,15 +9,11 @@ This playbook automates the installation and setup of the **stable** version of
sudo apt update
sudo apt install ansible -y
```
2. **UFW Ansible Collection:** The playbook uses the `community.general.ufw` module. Install it if you don't have it:
```bash
ansible-galaxy collection install community.general
```
3. **Sudo Access:** Your user must have `sudo` privileges to run the playbook.
2. **Sudo Access:** Your user must have `sudo` privileges to run the playbook.
## How to Run
1. **Customize Variables (Optional):** Open `playbook.yml` and review the `vars` section. You can change the storage pool driver, network settings, etc. The defaults are sensible for a standard ZFS-based setup.
1. **Customize Variables (Optional):** Open `playbook.yml` and review the `vars` section.
2. **Execute the Playbook:**
Run the following command from the same directory as the playbook file. It will prompt you for your `sudo` password to perform the administrative tasks.
@ -31,8 +27,23 @@ This playbook automates the installation and setup of the **stable** version of
After the playbook completes successfully:
1. **Log Out and Log Back In:** To apply the `incus-admin` group membership to your user session, you **must log out and log back in**. Alternatively, for the current session only, you can run `newgrp incus-admin`.
1. **Configure User Access:**
Add your user to incus-admin group
2. **Access the Web UI:** Open a browser and navigate to `https://localhost:8443`. You will need to accept the self-signed certificate.
```bash
sudo usermod -aG incus-admin $USER
```
To refresh group membership.
3. **Verify Setup:** You can test the installation by running `incus list`. If it runs without `sudo`, the setup is successful.
```bash
newgrp incus-admin
```
2. **Initialize Incus:**
Run the interactive initialization and follow the prompts to configure storage pools, networks, and other settings.
```bash
incus admin init
```
3. **Verify Setup:** You can test the installation by running `incus list`.