Local Environment Setup Guide

Local Development Environment Setup Guide 

Visual Studio Installation 

Prerequisites and Installation Steps 

1.  Download Visual Studio
   Install Visual Studio from the Visual Studio Marketplace.
2.  Obtain Professional License Access
   Ensure you have access to the Professional version of Visual Studio:
   1. Submit an access request through the Service Desk portal
   2. Notify your manager to approve the license request
3. Configure Installation Components
   During the Visual Studio installation process:
   1. When prompted, select the installation components screen
   2. Check the ASP.NET and web development workload
   3. his will automatically download all required dependencies and packages for EG-Flow development
   4. Click Install to begin the installation
4. Complete Installation
   The installer will now set up Visual Studio on your local machine. 

Check the image below. 

Project Setup and Configuration 

Cloning the EG-Flow Repository 

1. Access the Repository

1. Navigate to the EG-Flow repository on GitHub: EG-FLOW Repository 

• If you don't have repository access, request it through your manager 

• Copy either the HTTPS or SSH clone URL 

1. Clone Using Visual Studio

1. Follow these steps to clone the repository: 

• Launch Visual Studio 

• On the start screen, select Clone from GitHub 

• In the dialog that appears, paste the copied URL or browse repositories using the UI 

• Click Clone to download the project 

1. Explore the Project Structure

1. After cloning completes: 

• Open the Solution Explorer 

• You'll see the complete project structure 

• For detailed information about the project architecture, refer to the Project Structure Documentation 

1. Configure Startup Project

1. Set the correct startup project: 

• In Solution Explorer, right-click EGU.Flow.AppHost 

• Select Set as Startup Project 

1. Run the Application

1. Start the application: 

• Click the Start button (or press F5) 

• A browser window will launch displaying the Aspire default dashboard 

Note: Aspire is configured as the orchestrator for all projects in this solution 

Azure Storage Explorer Setup 

Azure Storage Explorer is a standalone application that allows you to manage Azure Storage resources (Blobs, Queues, and Tables) locally, eliminating the need to access the Azure Portal for routine operations. 

Installation 

1. Download Azure Storage Explorer from the official download page 

1. Run the installer and follow the on-screen instructions to complete the setup 

Azurite Local Emulator 

Azurite is a local Azure Storage emulator that simulates Azure Storage services (Blobs, Queues, and Tables) in your development environment. It functions similarly to Docker containers, providing a local runtime environment for storage-dependent code. 

Installation and Setup 

1. Install Node.js

1. Ensure you have Node.js installed (version 18 or higher) Installer Link 

1. Install Azurite

1. Open a terminal and run: 

• npm install -g azurite 

1. Start the Emulator

1. In your terminal, execute: 

• azurite 

1. Verify Operation

1. You should see log messages indicating that Azurite is running and listening on specific ports 

Connecting Azure Storage Explorer to Azurite 

Configuration Steps 

1. Verify Azurite is Running

1. Ensure the Azurite emulator is active in your terminal 

1. Connect in Azure Storage Explorer

1. Configure the connection: 

• Open Azure Storage Explorer 

• Navigate to Emulator & Attached in the left panel 

• Expand Local (Key) to view your local storage accounts 

• You can now browse and manage Blobs, Queues, and Tables locally 

Check the image below- 

Important: Keep Azurite running in the background whenever you're working on the EG-Flow project to ensure proper functionality of storage-dependent features.