Configure project environment types

Project environment types are a subset of the environment types configured for a dev center. They help preconfigure the environments that a specific development team can create.

In Azure Deployment Environments Preview, environment types that you add to the project will be available to developers when they deploy environments. Environment types determine the subscription and identity that are used for those deployments.

Project environment types enable development infrastructure teams to:

  • Configure the target subscription in which Azure resources will be created per environment type and per project.

    You can provide subscriptions for environment types in a project to automatically apply the right set of policies on environments. This action also abstracts Azure governance-related concepts from your development teams.

  • Preconfigure the managed identity that developers will use to perform the deployment, along with the access levels that development teams get after the environment is created.

In this article, you'll learn how to:

  • Add a new project environment type.
  • Update a project environment type.
  • Enable or disable a project environment type.
  • Delete a project environment type.

Important

Azure Deployment Environments is currently in preview. For legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability, see the Supplemental Terms of Use for Microsoft Azure Previews.

Prerequisites

Before you configure a project environment type, you need:

Add a new project environment type

When you configure a new project environment type, your development teams can use it to create an environment. They'll create the environment in the mapped subscription by using the configured deployment identity, along with permissions granted to resources created as part of the environment. All the associated policies are automatically applied.

Add a new project environment type as follows:

  1. Sign in to the Azure portal.

  2. Open Azure Deployment Environments.

  3. Select Projects from the left pane, and then select the specific project.

  4. Select Environment types from the left pane.

  5. Select + Add.

    Screenshot that shows selections for adding a project environment type.

  6. On the Add environment type to Project page, provide the following details:

    Name Value
    Type Select a dev center environment type to enable for the project.
    Deployment subscription Select the target subscription in which the environment will be created.
    Deployment identity Select either a system-assigned identity or a user-assigned managed identity that will be used to perform deployments on behalf of the user.
    Permissions on environment resources > Environment Creator Role(s) Select the roles that will get access to the environment resources.
    Permissions on environment resources > Additional access Select the users or Azure Active Directory groups that will be granted specific roles on the environment resources.
    Tags (optional) Provide a name and value for tags that will be applied on all resources created as part of the environments.

    Screenshot that shows adding details on the page for adding a project environment type.

Note

At least one identity (system assigned or user assigned) must be enabled for deployment identity. It will be used to perform the environment deployment on behalf of the developer. Additionally, the identity attached to the dev center should be granted Owner access to the deployment subscription configured per environment type.

Update a project environment type

You can update a project environment type so that it uses a different subscription or deployment identity when developers deploy environments. Updating a project environment type affects only the creation of new environments. Existing environments will continue to exist in the previously mapped subscription.

Update an existing project environment type as follows:

  1. In the Azure portal, open Azure Deployment Environments.
  2. Select Projects from the left pane, and then select the specific project.
  3. Select Environment types from the left pane.
  4. Select the environment type that you want to update.
  5. Select the Edit icon (image) on the specific row.
  6. On the Edit environment type page, update the previous configuration, and then select Submit.

Enable or disable a project environment type

You can disable a project environment type to prevent developers from using it to create environments. Disabling a project environment type doesn't affect existing environments.

When you enable an environment type (or re-enable one that you disabled), development teams can use it to create environments.

  1. In the Azure portal, open Azure Deployment Environments.
  2. Select Projects from the left pane, and then select the specific project.
  3. Select Environment types from the left pane.
  4. Select the environment type to enable or disable.
  5. Select Enable or Disable from the command bar and then confirm.

Delete a project environment type

You can delete a specific project environment type only if no deployed environments in the project are using it. After you delete a project environment type, development teams can't use it to create environments.

  1. In the Azure portal, open Azure Deployment Environments.
  2. Select Projects from the left pane, and then select the specific project.
  3. Select Environment types from the left pane.
  4. Select a project environment type to delete.
  5. Select Delete from the command bar and then confirm.

Next steps