Share via


Deploy a web app to an NGINX web server running on a Linux Virtual Machine (Classic)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Note

If you want to deploy your application to a Linux virtual machine using YAML pipelines, see Deploy to a Linux virtual machine.

Learn how to use Classic Azure Pipelines to build and deploy your web app to an NGINX web server running on a Linux virtual machine.

Prerequisites

Linux VM Prerequisites

  • If you don't have a Linux VM with an Nginx web server, follow the steps in this Quickstart to create one in Azure.

Get the code

If you don't have a repository, use the following sample project follow along with this tutorial:

https://github.com/MicrosoftDocs/pipelines-javascript

Build your app

Set up a deployment group

Deployment groups make it easier to organize the servers you want to use to host your app. A deployment group is a collection of machines with an Azure Pipelines agent on each of them. Each machine interacts with Azure Pipelines to coordinate deployment of your app.

  1. Open an SSH session to your Linux VM. You can do this using the Cloud Shell button in the upper-right of the Azure portal.

    A screenshot showing the azure cloud shell button

  2. Run the following command to initiate the session. Replace the placeholder with the IP address of your VM:

    ssh <publicIpAddress>
    
  3. Run the following command to install the required dependencies to set up the build and release agent on a Linux virtual machine. See Self-hosted Linux agents for more details.

    sudo apt-get install -y libunwind8 libcurl3
    
  4. in Azure DevOps web portal, select Pipelines, and then select Deployment groups.

  5. Select Add a deployment group (or New if you have existing deployment groups).

  6. Enter a name for the group such as myNginx and then select Create.

  7. Select Linux for the Type of target to register and make sure that Use a personal access token in the script for authentication is checked. Select Copy script to the clipboard. This script will install and configure an agent on your VM.

  8. Back in the SSH session in Azure portal, paste and run the script.

  9. When you're prompted to configure tags for the agent, press Enter to skip.

  10. Wait for the script to finish and display the message Started Azure Pipelines Agent. Type "q" to exit the file editor and return to the shell prompt.

  11. Back in Azure DevOps portal, on the Deployment groups page, open the myNginx deployment group. Select the Targets tab, and verify that your VM is listed.

Create a release pipeline

  1. Select Pipelines > Releases, and then select New pipeline.

  2. Select Empty job.

  3. Select Add an artifact to link your build artifact. Select Build, and then select your Project and Source from the dropdown menu. Select Add when you are done.

  4. Select the Continuous deployment icon, and the click the toggle button to enable the continuous deployment trigger. Add the main branch as a Build branch filter.

    A screenshot showing how to set up the continuous deployment trigger

  5. Select Tasks, and then select the Agent job and remove it.

    A screenshot showing how to remove the agent job

  6. Select the ellipsis icon, and then select Add a deployment group job. The tasks you will add to this job will run on each server in your deployment group.

    A screenshot showing how to add a deployment group job

  7. Select the deployment group you created earlier from the Deployment group dropdown menu.

    A screenshot showing how to select your deployment group.

  8. Select + to add a new task. Search for Bash and then select Add to add it to your pipeline.

    A screenshot showing how to add the bash task.

  9. Select the browse button to add the path of your deploy.sh script file. See a sample nodeJS deployment script here.

    A screenshot showing how to add the script path.

  10. Select Save when you are done.

    A screenshot showing how to save a release pipeline.

Deploy your app

  1. Select Releases, and then select Create a release.

  2. Make sure that the artifact version you want to use is selected and then select Create.

  3. Select the release link in the information bar message. For example: "Release Release-1 has been queued".

  4. Select the status link in Stages to see the deployment logs.

  5. After the release is complete, navigate to your app and verify its contents.