Exercise - Set up the project

Completed

You're a new developer at Tailwind Traders. Before you can start, you'll need to get your development environment configured. Don't worry, Tailwind Traders has made the onboarding process easy. There are just a few small steps you need to follow to get up and running.

Scaffold the project resources

  1. Sign into the Sandbox (also known as, "Tailwind Traders Production Environment") as indicated at the top of this page.

  2. Copy the following line, and paste it into the Sandbox terminal to the right.

    git clone https://github.com/MicrosoftDocs/mslearn-build-api-azure-functions && ./mslearn-build-api-azure-functions/DB_SETUP/CREATE_DATABASE.sh
    

    This will create a new database with product data. This process can take up to 10 minutes. Feel free to continue on with the Learn Module. The process will continue to run even if you leave this page.

Clone the project in Visual Studio Code

  1. Open Visual Studio Code.

  2. To open the View > Command Palette in Visual Studio Code.

  3. In the prompt, enter clone.

  4. From the Command Palette, select Git: Clone.

  5. Enter the following repo URL.

    https://github.com/MicrosoftDocs/mslearn-build-api-azure-functions
    
  6. Select a folder on your local drive where the project will be cloned.

  7. When prompted to open the cloned repository, select Open.

  8. Visual Studio Code will detect a workspace file in this project, and ask if you want to open it. Select Open Workspace.

    Screenshot of Visual Studio Code notification prompt to open workspace.

Two projects will appear in Visual Studio Code: "frontend" and "api". The "frontend" project contains the web app. The "api" project is where you will be building the serverless API with Azure Functions.

Run the frontend project

  1. To open the integrated terminal in Visual Studio Code, press Ctrl + Shift + `.

  2. Select "frontend".

  3. To run the frontend project in the browser, from the integrated terminal, run the npm start command.

    npm start
    

    A small webserver called "serve" should be running in your terminal. It will output the URL where the front-end app is running.

    Screenshot of Visual Studio Code terminal with a callout highlighting the url and port of running application.

  4. To open the app in the browser, select that URL in the terminal.

  5. The app will load, but there will be no data present. This is because you have not yet created the API for this app.

    Screenshot of the application running in a browser. No data is displayed and an error message explaining that the get operation failed.

Excellent! You've successfully configured your environment to be a productive developer at Tailwind Traders. That means that it's time to create the Azure Functions project that will serve as the API for the Products Manager application.