Andrea Daly


Setting Up Development Environment on MacOs

           
  1. Install Xcode Developer Tools (Choose one option):
  2. Install Git:
    • Option 1: Xcode
    • Install Xcode from the App Store.
    • Option 2: Command Line Tools (CLT) for Xcode
    • Open Terminal and run the following command:
    • xcode-select --install
  3. Install Homebrew:
  4. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  5. Update Homebrew:
  6. brew update
  7. Install Git:
  8. brew install git
  9. Verify Git version:
  10. git --version
  11. If the version is from Apple, update the PATH:
  12. export PATH=/usr/local/bin:$PATH
  13. Install Git Cola:
  14. brew install git-cola
  15. Set up GitLab Access:
  16. Set up SSH Keys for GitLab:
  17. Follow the steps in the guide for configuring new SSH keys.
  18. Install Node.js:
  19. brew install node
  20. Verify Node.js and NPM:
  21. node -v npm -v
  22. Install Nodemon:
  23. npm install -g nodemon
  24. Install MySQL:
  25. brew install mysql
  26. Set MySQL password:
  27. mysqladmin -u <admin-user-name> password
  28. Install Redis:
  29. brew install redis
  30. Install MongoDB:
  31. brew install mongodb
  32. Install IntelliJ IDEA Community Edition: Follow the installation instructions here
  33. Install Java 11:
  34. brew install java11
  35. Create a symlink for Java 11:
  36. sudo ln -sfn /usr/local/opt/openjdk@11/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-11.jdk
  37. Verify the installation:
  38. java --version
  39. Set Default JDK to Java 11: Follow the instructions here
  40. Install Python instructions here
  41. Install AWS CLI 2: Follow the instructions here
  42. Install AWS SAM CLI: Follow the instructions here
  43. Configure AWS SSO with AWS CLI: Follow the instructions here
  44. Install iTerm2: Download and install iTerm2 from here
  45. Install Oh My Zsh: Follow the instructions here
  46. Install Sublime Text: Download and install Sublime Text from here
  47. Install Postman:
  48. brew install --cask postman
  49. Download and install Postman from here.



Setting Up Development Environment on Windows

           
  1. Install Xcode Developer Tools (Choose one option):
  2. Install Git:
  3. Install Git from Git - Downloads
  4. Verify Git version:
  5. git --version
  6. If the version is from Apple, update the PATH:
  7. export PATH=/usr/local/bin:$PATH
  8. Install Git Cola:
  9. brew install git-cola
  10. Set up GitLab Access:
  11. Set up SSH Keys for GitLab:
  12. Follow the steps in the guide for configuring new SSH keys.
  13. Install Node.js from Node.js
  14. Verify Node.js and NPM:
  15. node -v npm -v
  16. Install Nodemon:
  17. npm install -g nodemon
  18. Install MySQL using the MySQL Installer
  19. Install Redis: from here
  20. Install MongoDB:
  21. Install IntelliJ IDEA Community Edition: Follow the installation instructions here
  22. Install Java 11:
  23. Download Java SE 11 from Java Archive Downloads
  24. Add installed JDK to PATH. Learn how from GeeksforGeeks
  25. Verify the installation:
  26. java --version
  27. Set Default JDK to Java 11: Follow the instructions here
  28. Install Python instructions here
  29. Install AWS CLI: Follow the instructions here
  30. Install AWS SAM CLI: Follow the instructions here
  31. Configure AWS SSO with AWS CLI: Follow the instructions here
  32. Install Sublime Text: Download and install Sublime Text from here
  33. Install Postman: Download and install Postman from here



New GitLab Users - Setting Up GitLab Keys on Linux WSL

In order to clone repositories down to your development environment, you will need to generate an SSH key pair specifically to use with GitLab.

Please follow the below instructions for setting up your GitLab keys on your Linux (WSL) or macOs development machine:

           
  1. Generate an SSH key:
  2. ssh-keygen

    The command will generate a public and private key pair and will ask you to enter a file in which to save the key (press enter to use the default location/file):

    Generating public/private rsa key pair. Enter file in which to save the key (/home/user/.ssh/id_rsa): Enter a passphrase for your key pair or leave empty: Enter passphrase (empty for no passphrase): Enter same passphrase again:

    Your public and private key will be saved in /home/user/.ssh

    Your public key has been saved in /home/user/.ssh/id_rsa.pub The key fingerprint is: SHA256: xyz The key's randomart image is: Ascii image...
  3. Saving your public key on GitLab:
  4. Once you have generated your key pair, you need to copy the public key to GitLab.

  5. Open the SSH public key file generated in the previous step using:
  6. cat ~/.ssh/id_rsa.pub
  7. Copy the contents of the SSH public key file to your clipboard and add to GitLab using the following steps.
  8. Navigate your profile icon in the top right-hand corner and in the drop-down menu, select Edit Profile. Once on your profile screen, select SSH Keys from the menu on the left-hand side and enter the content of your public SSH key in the text box under Add an SSH Key (the file should end with .pub). Once your key is in place, add a descriptive name and select the Add Key button.




New GitLab Users - Setting Up GitLab Keys on MacOS

In order to clone repositories down to your development environment, you will need to generate an SSH key pair specifically to use with GitLab.

Please follow the below instructions for setting up your GitLab keys on your macOS development machine:

          
  1. Generate an SSH key:
  2. ssh-keygen

    The command will generate a public and private key pair and will ask you to enter a file in which to save the key (press enter to use the default location/file):

    Generating public/private rsa key pair. Enter file in which to save the key (/Users/yourusername/.ssh/id_rsa): Enter a passphrase for your key pair or leave empty: Enter passphrase (empty for no passphrase): Enter same passphrase again:

    Your public and private key will be saved in /Users/yourusername/.ssh

    Your public key has been saved in /Users/yourusername/.ssh/id_rsa.pub The key fingerprint is: SHA256: xyz The key's randomart image is: Ascii image...
  3. Saving your public key on GitLab:
  4. Once you have generated your key pair, you need to copy the public key to GitLab.

  5. Open the SSH public key file generated in the previous step using:
  6. cat ~/.ssh/id_rsa.pub
  7. Copy the contents of the SSH public key file to your clipboard and add to GitLab using the following steps.
  8. Navigate your profile icon in the top right-hand corner and in the drop-down menu, select Edit Profile. Once on your profile screen, select SSH Keys from the menu on the left-hand side and enter the content of your public SSH key in the text box under Add an SSH Key (the file should end with .pub). Once your key is in place, add a descriptive name and select the Add Key button.




Installing Terraform on Linux (WSL)

Terraform is a powerful Infrastructure as Code (IaC) tool. Follow these steps to install Terraform on your Linux (WSL) development machine:

           
  1. Download Terraform:
  2. curl -O https://releases.hashicorp.com/terraform/0.14.7/terraform_0.14.7_linux_amd64.zip
  3. Unzip the downloaded package:
  4. unzip terraform_0.14.7_linux_amd64.zip
  5. Move the Terraform binary to a directory included in your system's PATH (e.g., /usr/local/bin/):
  6. sudo mv terraform /usr/local/bin/
  7. Verify the installation:
  8. terraform --version

    You should see Terraform's version information if the installation was successful.

  9. Create a Terraform Configuration File (e.g., main.tf):
  10. touch main.tf

    After running the above command, you will have created an empty Terraform configuration file named "main.tf". This file is where you define your infrastructure using HashiCorp Configuration Language (HCL).

    Edit the configuration file with your infrastructure code using a text editor of your choice. For example, you can use:

    nano main.tf

    This command opens the "main.tf" file in the chosen text editor. Add your Terraform configuration code to define and configure the desired infrastructure.

  11. Initialize the Terraform Configuration:
  12. terraform init

    This command initializes the working directory and downloads the necessary plugins.

  13. Review and Apply the Terraform Configuration:
  14. terraform apply

    Review the proposed changes and type "yes" to apply them. Terraform will provision the defined infrastructure.




Installing Terraform on macOS

Terraform is a powerful Infrastructure as Code (IaC) tool. Follow these steps to install Terraform on your macOS development machine:

          
  1. Install Homebrew (if not already installed):
  2. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  3. Install Terraform using Homebrew:
  4. brew install terraform
  5. Verify the installation:
  6. terraform --version

    You should see Terraform's version information if the installation was successful.

  7. Create a Terraform Configuration File (e.g., main.tf):
  8. touch main.tf

    After running the above command, you will have created an empty Terraform configuration file named "main.tf". This file is where you define your infrastructure using HashiCorp Configuration Language (HCL).

    Edit the configuration file with your infrastructure code using a text editor of your choice. For example, you can use:

    nano main.tf

    This command opens the "main.tf" file in the chosen text editor. Add your Terraform configuration code to define and configure the desired infrastructure.

  9. Initialize the Terraform Configuration:
  10. terraform init

    This command initializes the working directory and downloads the necessary plugins.

  11. Review and Apply the Terraform Configuration:
  12. terraform apply

    Review the proposed changes and type "yes" to apply them. Terraform will provision the defined infrastructure.




Installing Jenkins on Windows

Jenkins is a popular open-source automation server. Follow these steps to install Jenkins on your Windows machine:

         
  1. Download Jenkins MSI Installer from the official website:
  2. https://www.jenkins.io/download/
  3. Run the installer and follow the on-screen instructions to complete the installation.
  4. Access Jenkins in your web browser:
  5. http://localhost:8080

    Open the provided URL in your web browser. Follow the instructions to unlock Jenkins, retrieve the initial password, and complete the setup wizard.

  6. Install Jenkins plugins (Optional):
  7. Once Jenkins is running, you can install additional plugins based on your requirements. Navigate to Jenkins Dashboard > Manage Jenkins > Manage Plugins and install the desired plugins.




Installing Jenkins on Linux (WSL)

         
  1. Install Java Development Kit (JDK):
  2. sudo apt-get update sudo apt-get install openjdk-8-jdk
  3. Install Jenkins:
  4. sudo wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add - sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list' sudo apt-get update sudo apt-get install jenkins
  5. Start the Jenkins service:
  6. sudo systemctl start jenkins

    This command starts the Jenkins service.

  7. Access Jenkins in your web browser:
  8. http://localhost:8080

    Open the provided URL in your web browser. Follow the instructions to unlock Jenkins, retrieve the initial password, and complete the setup wizard.

  9. Install Jenkins plugins (Optional):
  10. Once Jenkins is running, you can install additional plugins based on your requirements. Navigate to Jenkins Dashboard > Manage Jenkins > Manage Plugins and install the desired plugins.




Installing Jenkins on macOS

Jenkins is a popular open-source automation server. Follow these steps to install Jenkins on your macOS machine:

        
  1. Install Homebrew (if not already installed):
  2. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  3. Install Jenkins using Homebrew:
  4. brew install jenkins
  5. Start the Jenkins service:
  6. brew services start jenkins

    This command starts the Jenkins service and ensures it starts automatically on system boot.

  7. Access Jenkins in your web browser:
  8. open http://localhost:8080

    Open the provided URL in your web browser. Follow the instructions to unlock Jenkins, retrieve the initial password, and complete the setup wizard.

  9. Install Jenkins plugins (Optional):
  10. Once Jenkins is running, you can install additional plugins based on your requirements. Navigate to Jenkins Dashboard > Manage Jenkins > Manage Plugins and install the desired plugins.




Installing Docker on MacOS

Docker is a platform for developing, shipping, and running applications in containers. Follow these steps to install Docker on your macOS machine:

       
  1. Download and install Docker Desktop from the official website:
  2. https://www.docker.com/products/docker-desktop
  3. Run the installer and follow the on-screen instructions to complete the installation.
  4. Start Docker Desktop from your Applications folder.
  5. Open a terminal and run the following command to verify the installation:
  6. docker --version

    You should see Docker's version information if the installation was successful.

  7. Run a test container to ensure Docker is working:
  8. docker run hello-world

    You should see a "Hello from Docker!" message, indicating that your Docker installation is operational.

  9. Explore Docker further:
  10. Now that Docker is installed, you can start building, running, and managing containers for your applications.




Installing Docker on Windows

Docker is a platform for developing, shipping, and running applications in containers. Follow these steps to install Docker on your Windows machine:

      
  1. Download and install Docker Desktop for Windows from the official website:
  2. https://www.docker.com/products/docker-desktop
  3. Run the installer and follow the on-screen instructions to complete the installation.
  4. Start Docker Desktop from the Start menu.
  5. Open a PowerShell or Command Prompt window and run the following command to verify the installation:
  6. docker --version

    You should see Docker's version information if the installation was successful.

  7. Run a test container to ensure Docker is working:
  8. docker run hello-world

    You should see a "Hello from Docker!" message, indicating that your Docker installation is operational.

  9. Explore Docker further:
  10. Now that Docker is installed, you can start building, running, and managing containers for your applications.




Creating an AWS Free Tier Account

AWS offers a Free Tier that includes a variety of services with limited usage for 12 months. Follow these steps to create your AWS Free Tier account:

     
  1. Visit the AWS Free Tier signup page:
  2. https://aws.amazon.com/free/
  3. Click on the "Create an AWS Account" button.
  4. Follow the on-screen instructions to provide your email address, create a password, and set up your AWS account.
  5. Enter your contact information and payment details (even though you won't be charged during the Free Tier period).
  6. Continue to the identity verification process by providing a phone number and entering the verification code.
  7. Choose a support plan (you can select the Free plan).
  8. Complete the signup process and log in to the AWS Management Console using your newly created credentials.
  9. Navigate to the AWS Free Tier Dashboard to monitor your usage and limits:
  10. https://aws.amazon.com/free/dashboard/

    Here, you can explore the available services and start using AWS within the Free Tier limits.




Setting Up AWS CLI and AWS SAM CLI on Windows

Follow these steps to install and configure the AWS CLI and AWS SAM CLI on your Windows machine:

    
  1. Install AWS CLI:
  2. Download the AWS CLI installer for Windows from here and follow the installation instructions.

  3. Check AWS CLI version:
  4. aws --version
  5. Make sure you have version 2.x installed.
  6. Configure AWS CLI:
  7. aws configure

    If using on a personal AWS account for training purposes, otherwise configure for SSO.

  8. Check IAM user:
  9. aws iam get-user

    If using on a personal AWS account for training purposes, otherwise configure for SSO.

  10. Check Java version:
  11. java -version
  12. Install AWS SAM CLI:
  13. Download the AWS SAM CLI installer for Windows from here and follow the installation instructions.

  14. Check SAM CLI installation:
  15. sam --version
  16. Install Docker:
  17. Download and install Docker Desktop for Windows from here.

  18. Check Docker version:
  19. docker --version
  20. Configure for SSO Using AWS SSO with AWS CLI:
  21. Follow the instructions here.

  22. Training Resources:
  23. AWS Command Line Interface - What is the AWS CLI?

    AWS Serverless Application Model - What is the AWS SAM CLI?




Setting Up AWS CLI and AWS SAM CLI on MacOs

Follow these steps to install and configure the AWS CLI and AWS SAM CLI on your machine:

   
  1. Install AWS CLI:
  2. brew install awscli

    OR

    Install or update the latest version of the AWS CLI - AWS Command Line Interface. from AWS and select Command line installer - all users
    . Follow on-screen instructions. * Recommended method.

  3. Check AWS CLI version:
  4. aws --version
  5. Make sure you have version 2.x installed.
  6. Configure AWS CLI:
  7. aws configure

    If using on a personal AWS account for training purposes, otherwise configure for SSO.

  8. Check IAM user:
  9. aws iam get-user

    If using on a personal AWS account for training purposes, otherwise configure for SSO.

  10. Check Java version:
  11. java -version
  12. Install AWS SAM CLI:
  13. Installing the AWS SAM CLI - AWS Serverless Application Model.

    brew install aws-sam-cli
  14. OR
  15. If you never installed the AWS cli via brew but installed via AWS do the same for the AWS SAM Cli
  16. Go to AWS and follow on-screen instructions.
  17. Check SAM CLI installation:
  18. which sam
  19. Install Docker:
  20. Get Docker from here.

  21. Check Docker version:
  22. docker --version
  23. Configure for SSO Using AWS SSO with AWS CLI:
  24. Follow the instructions here.

  25. Training Resources:
  26. AWS Command Line Interface - What is the AWS CLI?

    AWS Serverless Application Model - What is the AWS SAM CLI?




Installing Python on MacOS

Python is a powerful programming language. Follow these steps to install Python on your MacOS machine:

        
  1. Check if Python is already installed by opening Terminal and typing `python --version`. If Python is installed, this command will display the version number. If it's not installed, you'll see a message saying "command not found".
  2. If Python is not installed or you want to install a newer version, you can use Homebrew, a package manager for MacOS. If you haven't installed Homebrew yet, you can install it by pasting the following command in Terminal:
  3. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  4. Once Homebrew is installed, you can install Python by typing `brew install python`. This will install the latest version of Python.
  5. After the installation is complete, you can check the Python version again by typing `python --version`.
  6. Remember, you might need to replace `python` with `python3` in the commands above, depending on your system configuration.


Installing Python on Windows

Python is a powerful programming language. Follow these steps to install Python on your Windows machine:

       
  1. Go to the official Python downloads page at https://www.python.org/downloads/windows/.
  2. Click on the yellow button labeled "Latest Python Release". This will download the executable file for the latest version of Python.
  3. Once the download is complete, run the executable file. This will start the Python installer.
  4. In the first screen of the installation wizard, there will be an option at the bottom that says "Add Python to PATH". Make sure this option is checked. This will allow you to run Python from any directory without having to type the full path to the Python executable.
  5. Click "Install Now" and follow the prompts to complete the installation.
  6. After the installation is complete, you can verify the installation by opening Command Prompt and typing `python --version`. This should display the version number of the Python interpreter.