Setting Up Development Environment

Development Environment Setup for the Alliance Business Suite

Version: 1.1

Date: 28/08/2023

Setting up your development environment is the first essential step for effective contribution to the Alliance Business Suite. This page aims to guide you through setting up your development environment via Remote Desktop into the Corporate Server.

Table of Contents

  1. Overview
  2. Pre-requisites
  3. Remote Desktop into Corporate Server
  4. Setting up SSH for Azure DevOps
  5. Cloning the Repository
  6. Installing VS Code
  7. Configuring posh-git and oh-my-posh

Overview

To develop for the Alliance Business Suite, a properly configured environment is essential. This guide will help you to set up your environment using the Corporate Server.

Pre-requisites

Before setting up your development environment, make sure you have:

  • Network access to Alliance Business Suite resources
  • Proper credentials (Check with your team lead if you don't have them)
  • A computer that meets the system requirements

Remote Desktop into Corporate Server

Steps:

  1. Install RDP Client: Download and install the Remote Desktop Client for your OS.
  2. Request Credentials: Contact your team lead to obtain your credentials for Remote Desktop access.
  3. Configure RDP Client:
    • Open RDP and click on Add -> PCs.
    • Use fenixalliance.com.co for the PC Name, assign it a display name, and fill in your provided credentials.
  4. Connect and Validate:
    • Double-click on the newly created connection in RDP.
    • Confirm that you can successfully log in.

Setting up SSH for Azure DevOps

  1. Generate SSH Key: Open a terminal and run ssh-keygen -t rsa -b 4096. Follow the prompts to save the key.
  2. Add SSH Key to Azure DevOps:
    • Log into Azure DevOps
    • Navigate to your profile settings -> SSH Public Keys.
    • Click Add, give your key a name, and paste the contents of your SSH public key.
  3. Test SSH Connection: Run ssh -T git@ssh.dev.azure.com to confirm that SSH is set up correctly.

Cloning the Repository

  1. Open a Terminal: You can do this within your RDP session.
  2. Clone the Repository: Run git clone git@ssh.dev.azure.com:v3/fenixalliance/ABS/ABS.

Installing VS Code

  1. Download: Visit the VS Code website and download the installer for your OS.
  2. Install: Follow the installation instructions.
  3. Launch: Open VS Code to confirm that it is installed correctly.

Configuring posh-git and oh-my-posh

  1. Install posh-git: Run Install-Module posh-git -Scope CurrentUser in PowerShell.
  2. Install oh-my-posh: Run Install-Module oh-my-posh -Scope CurrentUser in PowerShell.
  3. Configure your PowerShell profile: Run notepad $PROFILE and add the following lines: 
    Import-Module posh-git
Import-Module oh-my-posh
Set-Theme Paradox