WIP

README.md

@@ -51,8 +51,7 @@ tāpēc ir svarīgi skatīties dokumentāciju moduļiem.
 Situācijā, kad izmaina kādu failu, iespējams vajag restartēt kādu servisu.
 Šim nolūkam izmanto *handlers* un *notify*.  
 
-
-##### Handlers
+**Kas? Ko?**
 Handleri, šajā situācijā, atrodās iekš `/roles/common/handlers/main.yml`  
 
 Šis fails ir strukturēts tā pat kā parasti playbook *task* faili, 
@@ -66,13 +65,13 @@ Pie kāda task var piesaistīt handler, tam pieliekot `notify: <handnler name>`
 (Piemērs iekš `/roles/common/tasks/syslog.yml`)
 
 **Kad handleri tiek laisti?**
-Vai handleris tikts laists, tiek noteikts pēc attiecīgā taska exit statusa!  
+Visi handleri tiek palaisti pašā playbook beigās!
+Un, vai handleris tikts laists, tiek noteikts pēc attiecīgā taska exit statusa!  
 Katram *task*am ir beigu statuss. Parasti - OK/CHANGED/SKIPPED  
 
 Ja task beidzās kā `CHANGED`, tad handleris tiks palaists, 
 bet ja ir `OK` vai `SKIPPED`, tad, nē.  
 
-Visi handleri tiek palaisti pašā playbook beigās!
 Ja ir vajadzība visus, līdz šim izsauktos, handlerus palaist ātrāk, 
 tad jāizmanto ansible `flush_handlers` task.
 
@@ -80,6 +79,7 @@ tad jāizmanto ansible `flush_handlers` task.
 - name: Flush handlers
     meta: flush_handlers
 ```
+#### Templates
 
 #### Vault
 
@@ -101,6 +101,6 @@ Pēc tam var karināt klāt dažādus "karogus":
 - `-k` - prasīs kādu SSH login paroli izmantot (ja vajag)
 - `-K` - prasīs kādu SUDO paroli izmantot (ja vajadzīga)
 - `--check`, `-C` - tā saucamais "dry-run", kur parāda tikai kas mainīsies, 
-un vai būs kādas kļūdas, bet reāli neko nemainīs (nestrādās ar dažiem moduļiem)
+un vai būs kādas kļūdas, bet uz gala sistēmas neko nemainīs (nestrādās ar dažiem moduļiem)
 - `--diff`, `-D` - visos taskos parāda kas ir mainījies (piemēram, failiem `diff` formātā)
 

roles/common/tasks/main.yml

@@ -1,5 +1,6 @@
+
 - name: Install basic packages
-  ansible.builtin.package:
+  ansible.builtin.package: # Šis ir moduļa FQCN (Fully Qualified Collection Name), bet var arī rakstīt vienkārši "package"
     name:
       - vim
       - htop
@@ -18,10 +19,19 @@
     dest: /etc/hosts
     owner: root
     group: root
-    mode: 0644
+    mode: 0644 # Mode nosaka piekļuves atļaujas `chmod` stilā. Vienīgi jāliek sākumā ekstra nulle lai ansible saprot, ka tas ir oktāls skaitlis. Vai arī neraksta nulli, bet liek pēdiņās.
 
 - name: Import syslog.yml
-  import_tasks: syslog.yml
+  import_tasks: syslog.yml # import_tasks atļauj importēt taskus no cita faila
+
+# - name: Import snmp.yml
+#   import_tasks: snmp.yml
+# 
+# - name: Import ldap.yml
+#   import_tasks: ldap.yml
+# 
+# - name: Import share.yml
+#   import_tasks: share.yml
 
 - name: Import webserver.yml
   import_tasks: webserver.yml

roles/common/tasks/webserver.yml

@@ -7,9 +7,10 @@
     state: present
 
 - name: Remove default website
-  ansible.builtin.file:
+  ansible.builtin.file: # file moduli izmanto, lai veidotu failus un mapes.
     path: /var/www/html
-    state: absent
+    state: absent # Var arī dzēst :D
+    # Tur var arī likt "directory" vai "file" un kā tālāk redzams noteikt piekļuves atļaujas.
 
 - name: Create default site directory
   ansible.builtin.file:
@@ -20,7 +21,7 @@
     mode: 0755
 
 - name: Copy default index
-  ansible.builtin.template:
+  ansible.builtin.template: # Template strādā līdzīgi kā nākošais copy task, izņemot tas ka šis uztveris failu kā jinja2 template failu.
     src: var/www/default/index.html
     dest: /var/www/default/index.html
     owner: www-data
@@ -40,7 +41,7 @@
   ansible.builtin.file:
     path: /etc/nginx/sites-enabled/default
     src: /etc/nginx/sites-available/default
-    state: link
+    state: link # izmanto arī lai veidotu symlinks
     owner: root
     group: root
     mode: 0644