Added command aliases

Signed-off-by: alexmerlin <[email protected]>

Author: alexmerlin

wsl/os/almalinux9/FAQ.md

@@ -1,6 +1,5 @@
 # Frequently Asked Questions
 
-
 ## How do I switch to a different version of PHP?
 
 ### Switch to PHP 8.3
@@ -19,7 +18,6 @@
 
     sudo dnf module switch-to php:remi-7.4 -y
 
-
 ## How do I switch to a different version of Node.js?
 
 ### Switch to Node.js 22.x
@@ -40,31 +38,13 @@
     curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
     sudo dnf install nodejs -y
 
-### Switch to Node.js 16.x
-
-    sudo dnf remove nodejs -y
-    curl -fsSL https://rpm.nodesource.com/setup_16.x | sudo bash -
-    sudo dnf install nodejs -y
-
-### Switch to Node.js 14.x
-
-    sudo dnf remove nodejs -y
-    curl -fsSL https://rpm.nodesource.com/setup_14.x | sudo bash -
-    sudo dnf install nodejs -y
-
-### Switch to Node.js 12.x
-
-    sudo dnf remove nodejs -y
-    curl -fsSL https://rpm.nodesource.com/setup_12.x | sudo bash -
-    sudo dnf install nodejs -y
-
-**Note**: Node.js 12.x is no longer actively supported!
-
 
 ## How do I fix common permission issues?
+
 If running your project you encounter some permission issues, follow the below steps.
 
 ### Errors:
+
 > PHP Fatal error:  Uncaught InvalidArgumentException: The directory "/var/www/_example.local_/html/data" is not writable...
 
 > PHP Fatal error:  Uncaught InvalidArgumentException: The directory "/var/www/_example.local_/html/data/cache" is not writable...
@@ -75,18 +55,39 @@ If running your project you encounter some permission issues, follow the below s
 
     chmod -R 777 data
 
-
 ### Error:
+
 > PHP Fatal error:  Uncaught InvalidArgumentException: The directory "/var/www/_example.local_/html/public/uploads" is not writable...
 
 **Fix:**
 
     chmod -R 777 public/uploads
 
-
 ### Error:
+
 > PHP Fatal error:  Uncaught ErrorException: fopen(/var/www/_example.local_/config/autoload/../../log/error-log-_yyyy-mm-dd.log_): Failed to open stream: Permission denied...
 
 **Fix:**
 
     chmod -R 777 log
+
+## How do I create command aliases?
+
+From either your terminal or file explorer, navigate to your home directory (`/home/<your-username>/`).
+
+Using your preferred text editor, open the file: `.bash_profile` (if it does not exist, creat it first).
+
+Move to the end of the file and enter on a new line:
+
+    alias command_alias="command to execute"
+
+where:
+
+- `command_alias` is the name by which you want to call your original command
+- `command to execute`: the original command to be executed on alias call
+
+### Example:
+
+    alias list_files="ls -Al"
+
+will create an alias called `list_files` that will run the command `ls -Al`.

wsl/os/almalinux9/roles/system/tasks/main.yml

@@ -15,3 +15,7 @@
   template:
     src: wsl.conf.j2
     dest: "{{ wsl_config_dest }}"
+- name: Copy .bash_profile file
+  template:
+    src: bash_profile.j2
+    dest: "{{ bash_profile_dest }}"

wsl/os/almalinux9/roles/system/templates/bash_profile.j2

@@ -0,0 +1,10 @@
+# PHP version switcher commands
+alias php74="sudo dnf module switch-to php:remi-7.4 -y"
+alias php81="sudo dnf module switch-to php:remi-8.1 -y"
+alias php82="sudo dnf module switch-to php:remi-8.2 -y"
+alias php83="sudo dnf module switch-to php:remi-8.3 -y"
+
+# Node.js version switcher commands
+alias node18="sudo dnf remove nodejs -y && curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash - && sudo dnf install nodejs -y"
+alias node20="sudo dnf remove nodejs -y && curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash - && sudo dnf install nodejs -y"
+alias node22="sudo dnf remove nodejs -y && curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash - && sudo dnf install nodejs -y"

wsl/os/almalinux9/roles/system/vars/main.yml

@@ -1,2 +1,3 @@
 ---
 wsl_config_dest: /etc/wsl.conf
+bash_profile_dest: "/home/{{ config.system.username }}/.bash_profile"