Skip to content

Latest commit

 

History

History
147 lines (93 loc) · 7.5 KB

azure-devops-project-python.md

File metadata and controls

147 lines (93 loc) · 7.5 KB
title description ms.prod ms.technology services documentationcenter author manager editor ms.assetid ms.workload ms.tgt_pltfrm ms.devlang ms.topic ms.date ms.author ms.custom monikerRange
Quickstart: Create a CI/CD pipeline for Python with Azure DevOps Projects
DevOps Projects makes it easy to get started with Azure. It helps you launch an app on an Azure service of your choice in few quick steps.
devops
devops-cicd
vsts
vs-devops-build
mlearned
douge
web
na
na
quickstart
07/09/2018
mlearned
mvc
vsts

Create a CI/CD pipeline for Python with Azure DevOps Projects

Azure DevOps Projects presents a simplified experience that creates Azure resources and sets up a continuous integration (CI) and continuous delivery (CD) pipeline for your Python app.

If you don't have an Azure subscription, you can get one for free through Visual Studio Dev Essentials.

Sign in to the Azure portal

DevOps Projects creates a CI/CD pipeline in Azure Pipelines. You can create a free new Azure DevOps organization or use an existing organization. DevOps Projects also creates Azure resources in the Azure subscription of your choice.

  1. Sign in to the Microsoft Azure portal.

  2. Select the Create a resource icon in the left pane, and then search for DevOps Projects.

  3. Select Create.

    Starting Continuous Delivery configuration

Select a sample application and Azure service

  1. Select the Python sample application. The Python samples include a choice of several application frameworks.

  2. The default sample framework is Django. Leave the default setting, and then select Next.
    Web App For Containers is the default deployment target. The application framework, which you chose previously, dictates the type of Azure service deployment target available here.

  3. Leave the default service, and then select Next.

Configure Azure DevOps and an Azure subscription

  1. Create a new Azure DevOps organization or choose an existing organization.

    a. Enter a name for your project in Azure DevOps.

    b. Select your Azure subscription and location, enter a name for your application, and then select Done.
    After few minutes, the project dashboard is displayed in the Azure portal. A sample application is set up in a repository in your Azure DevOps organization, a build is executed, and your application is deployed to Azure. This dashboard provides visibility into your code repository, your CI/CD pipeline, and your application in Azure.

  2. Select Browse to view your running application.

    Dashboard view

DevOps Projects automatically configures a CI build and release trigger. You're now ready to collaborate with a team on a Python app by using a CI/CD process that automatically deploys your latest work to your website.

Commit code changes and execute CI/CD

DevOps Projects creates a Git repository in Azure Repos or GitHub. To view the repository and make code changes to your application, do the following:

  1. On the left side of the DevOps Projects dashboard, select the link for your master branch.
    This link opens a view to the newly created Git repository.

  2. To view the repository clone URL, select Clone from the top right of the browser.
    You can clone your Git repository in your favorite IDE. In the next few steps, you can use the web browser to make and commit code changes directly to the master branch.

  3. On the left, go to the app/templates/app/index.html file.

  4. Select Edit, and make a change to some of the text. For example, change some of the text for one of the div tags.

  5. Select Commit, and then save your changes.

  6. In your browser, go to the DevOps Projects dashboard.
    You should now see a build in progress. The changes you just made are automatically built and deployed via a CI/CD pipeline.

Examine the CI/CD pipeline

In the previous step, DevOps Projects automatically configured a full CI/CD pipeline. Explore and customize the pipeline as needed. To familiarize yourself with the build and release pipelines, do the following:

  1. At the top of the DevOps Projects dashboard, select Build Pipelines.
    A browser tab displays the build pipeline for your new project.

  2. Point to the Status field, and then select the ellipsis (...).
    A menu displays several options, such as queueing a new build, pausing a build, and editing the build pipeline.

  3. Select Edit.

  4. In this pane, you can examine the various tasks for your build pipeline.
    The build performs various tasks such as fetching sources from the Git repository, restoring dependencies, and publishing outputs for deployments.

  5. At the top of the build pipeline, select the build pipeline name.

  6. Change the name of your build pipeline to something more descriptive, select Save & queue, and then select Save.

  7. Under your build pipeline name, select History.
    You see an audit trail of your recent changes for the build. Azure DevOps keeps track of any changes made to the build pipeline, and it allows you to compare versions.

  8. Select Triggers.
    DevOps Projects automatically creates a CI trigger, and every commit to the repository starts a new build. You can optionally choose to include or exclude branches from the CI process.

  9. Select Retention.
    Depending on your scenario, you can specify policies to keep or remove a certain number of builds.

  10. Select Build and Release, and then choose Releases.
    DevOps Projects creates a release pipeline to manage deployments to Azure.

  11. Select the ellipsis next to your release pipeline, and then select Edit.
    The release pipeline defines the release process.

  12. Under Artifacts, select Drop.
    The build pipeline you examined in the previous steps produces the output that's used for the artifact.

  13. Next to the Drop icon, select the Continuous deployment trigger.
    The release pipeline has an enabled CD trigger, which runs a deployment every time there's a new build artifact available. Optionally, you can disable the trigger so that your deployments require manual execution.

  14. On the left, select Tasks.
    The tasks are the activities that your deployment process performs. In this example, a task was created to deploy to Azure App Service.

  15. On the right, select View releases to display a history of releases.

  16. Select the ellipsis (...) next to one of your releases, and then select Open.
    There are several menus to explore from this view, such as a release summary, associated work items, and tests.

  17. Select Commits. This view shows the code commits that are associated with the specific deployment.

  18. Select Logs.
    The logs contain useful information about the deployment process. You can view them both during and after deployments.

Clean up resources

You can delete Azure App Service and related resources when you don't need them anymore. Use the Delete functionality on the DevOps Projects dashboard.

Next steps

When you configured your CI/CD process, build and release pipelines were automatically created. You can modify these build and release pipelines to meet the needs of your team. To learn more about the CI/CD pipeline, see:

[!div class="nextstepaction"] Customize CD process