diff --git a/docs/books/incus_server/30-appendix_a.de.md b/docs/books/incus_server/30-appendix_a.de.md new file mode 100644 index 0000000000..e2e4c97480 --- /dev/null +++ b/docs/books/incus_server/30-appendix_a.de.md @@ -0,0 +1,184 @@ +--- +title: Appendix A - Workstation Setup +author: Steven Spencer +contributors: Ganna Zhyrnova +tested_with: 9.4 +tags: + - incus + - workstation +--- + +# Anhang A – Workstation-Setup + +Obwohl dies nicht Teil der Kapitel für einen Incus-Server ist, wird dieses Verfahren denjenigen helfen, die eine Laborumgebung oder ein semi-permanentes Betriebssystem und Anwendungen auf einer Rocky Linux-Workstation oder einem Notebook betreiben möchten. + +## Voraussetzungen + +- Erfahrung mit der Kommandozeile +- sicheren Umgang mit einen Kommandozeileneditor wie `vi` oder `nano` +- Bedarf nach einer stabilen Testumgebung, die regelmäßig verwendet werden kann +- in der Lage sein, `root` zu werden oder mit `sudo` erweiterte Berechtigungen zu bekommen + +## Installation + +Installieren Sie das EPEL-Repository über die Befehlszeile: + +```bash +sudo dnf install epel-release -y +``` + +When the installation finishes, do an upgrade: + +```bash +sudo dnf upgrade +``` + +Installation anderer Repositories: + +```bash +sudo dnf config-manager --enable crb +sudo dnf copr enable neil/incus +``` + +Benötigte Pakete installieren: + +```bash +sudo dnf install dkms vim kernel-devel bash-completion +``` + +Incus installieren und aktivieren: + +```bash +sudo dnf install incus incus-tools +sudo systemctl enable incus +``` + +Please reboot your notebook or workstation before you continue. + +## Incus-Initialisierung + +If you have looked through the production server chapters, this is nearly identical to the production server initialization procedure. + +```bash +sudo incus admin init +``` + +This will start a question-and-answer dialog. + +Here are the questions and our answers for the script, with a little explanation where warranted: + +```text +Would you like to use clustering? (yes/no) [default=no]: no +Do you want to configure a new storage pool? (yes/no) [default=yes]: yes +Name of the new storage pool [default=default]: storage +``` + +Jetzt können Sie die Default-Einstellung verwenden. + +```text +Name of the storage backend to use (btrfs, dir, lvm, ceph) [default=btrfs]: dir +``` + +Note that `dir` is somewhat slower than `zfs`. If you can leave a disk empty, you can use that device (example: /dev/sdb) for the `zfs` device and then select `zfs`. + +```text +Would you like to connect to a MAAS server? (yes/no) [default=no]: +``` + +Metal As A Service (MAAS) is outside the scope of this document. + +```text +Would you like to create a new local network bridge? (yes/no) [default=yes]: +What should the new bridge be called? [default=incusbr0]: +What IPv4 address should be used? (CIDR subnet notation, “auto” or “none”) [default=auto]: +What IPv6 address should be used? (CIDR subnet notation, “auto” or “none”) [default=auto]: none +``` + +Sie können diese Option aktivieren, wenn Sie IPv6 auf Ihren `Incus`-Containern verwenden möchten. + +```text +Would you like the Incus server to be available over the network? (yes/no) [default=no]: yes +``` + +This is necessary to snapshot the workstation. Bitte hier mit "yes" antworten. + +```text +Address to bind Incus to (not including port) [default=all]: +Port to bind Incus to [default=8443]: +Trust password for new clients: +Again: +``` + +This trust password is how you will connect to or back from the snapshot server. Set it with something that makes sense in your environment. Speichern Sie diesen Eintrag an einem sicheren Ort, wie zum Beispiel einem Passwort-Manager. + +```text +Would you like stale cached images to be updated automatically? (yes/no) [default=yes] +Would you like a YAML "incus admin init" preseed to be printed? (yes/no) [default=no]: +``` + +## Benutzerrechte + +The next thing you need to do is to add your user to the `incus-admin` group. Again, you will need to use `sudo` or be root for this: + +```text +sudo usermod -a -G incus-admin [username] +``` + +Where [username] is your user on the system. + +## Festlegen der Werte `subuid` und `subgid` für `root` + +Sie müssen sowohl den Wert für die `subuid` als auch für die `subgid` des Root-Benutzers festlegen (den Bereich der untergeordneten Benutzer- und Gruppen-IDs). Dieser Wert sollte, wie folgt, sein: + +```bash +root:1000000:1000000000 +``` + +Bearbeiten Sie dazu die Datei `/etc/subuid` und fügen Sie diese Zeile hinzu. Nach dem Edit sieht Ihre Datei wie folgt aus: + +```bash +root:1000000:1000000000 +``` + +Fügen Sie diese Zeile erneut der Datei `/etc/subgid` hinzu. Ihre Datei sieht in etwa so aus: + +```bash +incusadmin:100000:65536 +root:1000000:1000000000 +``` + +You have made a number of changes at this point. Starten Sie Ihren Computer neu, bevor Sie fortfahren. + +## Überprüfung der Installation + +To ensure that `incus` started and that your user has privileges, from the shell prompt do: + +```text +incus list +``` + +Bitte beachten Sie, dass Sie hier nicht einmal `sudo` verwendet haben. Ihr Benutzer kann diese Befehle eingeben. Sie sollten so etwas erhalten: + +```bash ++------------+---------+----------------------+------+-----------+-----------+ +| NAME | STATE | IPV4 | IPV6 | TYPE | SNAPSHOTS | ++------------+---------+----------------------+------+-----------+-----------+ +``` + +Wenn ja, dann sieht es gut aus! + +## Zum Abschluss + +From this point, you can use the chapters from our "Incus Production Server" to continue. There are some things on a workstation setup that you need to pay less attention to. Hier sind die empfohlenen Kapitel, um Ihnen den Einstieg zu erleichtern: + +- [Kapitel 5 - Einrichten und Verwalten von Images](05-incus_images.md) +- [Kapitel 6 - Profile](06-profiles.md) +- [Kapitel 8 - Container Snapshots](08-snapshots.md) + +## Weitere Informationen + +- [Offizielle Incus-Übersicht und Dokumentation](https://linuxcontainers.org/incus/docs/main/) + +## Zusammenfassung + +Incus ist ein leistungsstarkes Tool zur Steigerung der Produktivität auf Workstations oder Servern. Es eignet sich hervorragend für Labortests auf einer Workstation und kann auch halbpermanente Instanzen von Betriebssystemen und Anwendungen in einem eigenen, privaten Bereich bereithalten. diff --git a/docs/books/incus_server/30-appendix_a.es.md b/docs/books/incus_server/30-appendix_a.es.md new file mode 100644 index 0000000000..11b4c6a1eb --- /dev/null +++ b/docs/books/incus_server/30-appendix_a.es.md @@ -0,0 +1,184 @@ +--- +title: Appendix A - Workstation Setup +author: Steven Spencer +contributors: Ganna Zhyrnova +tested_with: 9.4 +tags: + - incus + - estación de trabajo +--- + +# Appendix A - workstation setup + +While not part of the chapters for an Incus Server, this procedure will help those who want to have a lab environment or semi-permanent OS and application running on a Rocky Linux workstation or notebook. + +## Prerrequisitos + +- comfortable at the command line +- able to use a command line editor, such as `vi` or `nano` fluently +- a need for a stable testing environment used every day or as needed +- able to become root or have `sudo` privileges + +## Instalación + +From the command line, install the EPEL repository: + +```bash +sudo dnf install epel-release -y +``` + +When the installation finishes, do an upgrade: + +```bash +sudo dnf upgrade +``` + +Install other repositories: + +```bash +sudo dnf config-manager --enable crb +sudo dnf copr enable neil/incus +``` + +Install some needed packages: + +```bash +sudo dnf install dkms vim kernel-devel bash-completion +``` + +Install and enable Incus: + +```bash +sudo dnf install incus incus-tools +sudo systemctl enable incus +``` + +Please reboot your notebook or workstation before you continue. + +## Inicialización de `Incus` + +If you have looked through the production server chapters, this is nearly identical to the production server initialization procedure. + +```bash +sudo incus admin init +``` + +This will start a question-and-answer dialog. + +Here are the questions and our answers for the script, with a little explanation where warranted: + +```text +Would you like to use clustering? (yes/no) [default=no]: no +Do you want to configure a new storage pool? (yes/no) [default=yes]: yes +Name of the new storage pool [default=default]: storage +``` + +Optionally, you can accept the default. + +```text +Name of the storage backend to use (btrfs, dir, lvm, ceph) [default=btrfs]: dir +``` + +Note that `dir` is somewhat slower than `zfs`. If you can leave a disk empty, you can use that device (example: /dev/sdb) for the `zfs` device and then select `zfs`. + +```text +Would you like to connect to a MAAS server? (yes/no) [default=no]: +``` + +Metal As A Service (MAAS) is outside the scope of this document. + +```text +Would you like to create a new local network bridge? (yes/no) [default=yes]: +What should the new bridge be called? [default=incusbr0]: +What IPv4 address should be used? (CIDR subnet notation, “auto” or “none”) [default=auto]: +What IPv6 address should be used? (CIDR subnet notation, “auto” or “none”) [default=auto]: none +``` + +You can turn on this option if you want to use IPv6 on your Incus containers. + +```text +Would you like the Incus server to be available over the network? (yes/no) [default=no]: yes +``` + +This is necessary to snapshot the workstation. Answer "yes" here. + +```text +Address to bind Incus to (not including port) [default=all]: +Port to bind Incus to [default=8443]: +Trust password for new clients: +Again: +``` + +This trust password is how you will connect to or back from the snapshot server. Set it with something that makes sense in your environment. Save this entry to a secure location, such as a password manager. + +```text +Would you like stale cached images to be updated automatically? (yes/no) [default=yes] +Would you like a YAML "incus admin init" preseed to be printed? (yes/no) [default=no]: +``` + +## User privileges + +The next thing you need to do is to add your user to the `incus-admin` group. Again, you will need to use `sudo` or be root for this: + +```text +sudo usermod -a -G incus-admin [username] +``` + +Where [username] is your user on the system. + +## Setting `subuid` and `subgid` values for `root` + +You must set both the value of the root user's `subuid` and `subgid` (the range of subordinate user and group IDs). This value should be: + +```bash +root:1000000:1000000000 +``` + +To do this, edit the `/etc/subuid` and add that line. When completed, your file will be: + +```bash +root:1000000:1000000000 +``` + +Add that line again to the `/etc/subgid` file. Your file will look something like this: + +```bash +incusadmin:100000:65536 +root:1000000:1000000000 +``` + +You have made a number of changes at this point. Before you proceed, reboot your machine. + +## Verifying the install + +To ensure that `incus` started and that your user has privileges, from the shell prompt do: + +```text +incus list +``` + +Note you have not used `sudo` here. Your user can enter these commands. You will see something like this: + +```bash ++------------+---------+----------------------+------+-----------+-----------+ +| NAME | STATE | IPV4 | IPV6 | TYPE | SNAPSHOTS | ++------------+---------+----------------------+------+-----------+-----------+ +``` + +If you do, you are looking good! + +## The rest of it + +From this point, you can use the chapters from our "Incus Production Server" to continue. There are some things on a workstation setup that you need to pay less attention to. Here are the recommended chapters to get you going: + +- [Chapter 5 - Setting Up And Managing Images](05-incus_images.md) +- [Chapter 6 - Profiles](06-profiles.md) +- [Chapter 8 - Container Snapshots](08-snapshots.md) + +## Más lectura + +- [Official Incus Overview and Documentation](https://linuxcontainers.org/incus/docs/main/) + +## Conclusión + +Incus is a powerful tool for increased productivity on workstations or servers. It is great for lab testing on a workstation and can also keep semi-permanent instances of operating systems and applications available in their own private space. diff --git a/docs/books/incus_server/30-appendix_a.fr.md b/docs/books/incus_server/30-appendix_a.fr.md index 84ac25aaee..ac8a4ea79f 100644 --- a/docs/books/incus_server/30-appendix_a.fr.md +++ b/docs/books/incus_server/30-appendix_a.fr.md @@ -1,14 +1,14 @@ --- -title: Annexe A - Configuration du poste de travail +title: Annexe A - Mise en place du poste de travail author: Steven Spencer contributors: Ganna Zhyrnova tested_with: 9.4 tags: - incus - - poste de travail + - workstation --- -# Annexe A - Configuration du poste de travail +# Annexe A - Mise en place du poste de travail Bien que ne faisant pas partie des chapitres relatifs à un serveur `Incus`, cette procédure aidera ceux qui souhaitent disposer d'un environnement de laboratoire ou d'un système d'exploitation et d'une application semi-permanents exécutés sur un poste de travail ou un ordinateur portable Rocky Linux. @@ -100,7 +100,7 @@ Vous pouvez activer cette option si vous souhaitez utiliser IPv6 sur vos contene Would you like the Incus server to be available over the network? (yes/no) [default=no]: yes ``` -Cette opération est nécessaire pour effectuer un instantané de la station de travail. Répondez « oui » ici. +Cette opération est nécessaire pour effectuer un instantané de la station de travail. Répondez `yes` ici. ```text Address to bind Incus to (not including port) [default=all]: @@ -157,7 +157,7 @@ Pour vous assurer que `incus` a démarré et que votre utilisateur dispose des p incus list ``` -Notez que nous n'avons pas utilisé `sudo` ici. Votre utilisateur peut tout à fait exécuter ces commandes. Vous verrez quelque chose comme ceci : +Notez que nous n'avons pas utilisé `sudo` ici. Votre utilisateur peut tout à fait exécuter ces commandes. Vous devriez obtenir quelque chose de similaire à ce qui suit : ```bash +------------+---------+----------------------+------+-----------+-----------+ diff --git a/docs/books/incus_server/30-appendix_a.it.md b/docs/books/incus_server/30-appendix_a.it.md index 0fdd3fad0a..b125fad563 100644 --- a/docs/books/incus_server/30-appendix_a.it.md +++ b/docs/books/incus_server/30-appendix_a.it.md @@ -1,6 +1,6 @@ --- title: Appendice A - Configurazione Workstation -author: Spencer Steven +author: Steven Spencer contributors: Ganna Zhyrnova tested_with: 9.4 tags: @@ -65,7 +65,7 @@ sudo incus admin init Si aprirà una finestra di dialogo a domande e risposte. -Ecco le domande e le nostre risposte per lo script, con una piccola spiegazione dove necessario: +Ecco le domande e le nostre risposte per il copione, con una piccola spiegazione dove necessario: ```text Would you like to use clustering? (yes/no) [default=no]: no @@ -85,7 +85,7 @@ Si noti che `dir` è un po' più lento di `zfs`. Se si può lasciare un disco vu Would you like to connect to a MAAS server? (yes/no) [default=no]: ``` -Il Metal As A Service (MAAS) non rientra nell'ambito di questo documento. +Metal As A Service (MAAS) non rientra nel campo di applicazione del presente documento. ```text Would you like to create a new local network bridge? (yes/no) [default=yes]: @@ -100,7 +100,7 @@ What IPv6 address should be used? (CIDR subnet notation, “auto” or “none Would you like the Incus server to be available over the network? (yes/no) [default=no]: yes ``` -Questa operazione è necessaria per eseguire lo snapshot della workstation. Rispondere "sì" in questo caso. +Questa operazione è necessaria per eseguire lo snapshot della workstation. Rispondere "yes" in questo caso. ```text Address to bind Incus to (not including port) [default=all]: @@ -165,7 +165,7 @@ Si noti che qui non è stato usato `sudo`. L'utente può inserire questi comandi +------------+---------+----------------------+------+-----------+-----------+ ``` -Se lo fate, avete un bell'aspetto! +Se lo fate, state andando alla grande! ## Il resto