Compartilhar via


Devcenters/catálogos do Microsoft.DevCenter 2024-02-01

Definição de recurso do Bicep

O tipo de recurso de devcenters/catálogos pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DevCenter/devcenters/catalogs, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.DevCenter/devcenters/catalogs@2024-02-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    adoGit: {
      branch: 'string'
      path: 'string'
      secretIdentifier: 'string'
      uri: 'string'
    }
    gitHub: {
      branch: 'string'
      path: 'string'
      secretIdentifier: 'string'
      uri: 'string'
    }
    syncType: 'string'
    tags: {
      {customized property}: 'string'
    }
  }
}

Valores da propriedade

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
name O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.
Nome simbólico do recurso do tipo: devcenters
properties Propriedades do catálogo. CatalogProperties

CatalogProperties

Name Description Value
adoGit Propriedades para um tipo de catálogo do Azure DevOps. GitCatalog
gitHub Propriedades de um tipo de catálogo do GitHub. GitCatalog
syncType Indica o tipo de sincronização configurado para o catálogo. 'Manual'
'Scheduled'
tags Tags de recursos. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Branch do Git. cadeia
caminho A pasta em que os itens de catálogo podem ser encontrados dentro do repositório. cadeia
secretIdentifier Uma referência ao segredo do Key Vault que contém um token de segurança para autenticar em um repositório Git. cadeia
uri URI do Git. cadeia

Exemplos de uso

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Description
configurar o serviço ambientes de implantação Esse modelo fornece uma maneira de configurar ambientes de implantação.

Definição de recurso de modelo do ARM

O tipo de recurso de devcenters/catálogos pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DevCenter/devcenters/catalogs, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.DevCenter/devcenters/catalogs",
  "apiVersion": "2024-02-01",
  "name": "string",
  "properties": {
    "adoGit": {
      "branch": "string",
      "path": "string",
      "secretIdentifier": "string",
      "uri": "string"
    },
    "gitHub": {
      "branch": "string",
      "path": "string",
      "secretIdentifier": "string",
      "uri": "string"
    },
    "syncType": "string",
    "tags": {
      "{customized property}": "string"
    }
  }
}

Valores da propriedade

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
apiVersion A versão da API '2024-02-01'
name O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obrigatório)
properties Propriedades do catálogo. CatalogProperties
tipo O tipo de recurso 'Microsoft.DevCenter/devcenters/catalogs'

CatalogProperties

Name Description Value
adoGit Propriedades para um tipo de catálogo do Azure DevOps. GitCatalog
gitHub Propriedades de um tipo de catálogo do GitHub. GitCatalog
syncType Indica o tipo de sincronização configurado para o catálogo. 'Manual'
'Scheduled'
tags Tags de recursos. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Branch do Git. cadeia
caminho A pasta em que os itens de catálogo podem ser encontrados dentro do repositório. cadeia
secretIdentifier Uma referência ao segredo do Key Vault que contém um token de segurança para autenticar em um repositório Git. cadeia
uri URI do Git. cadeia

Exemplos de uso

Modelos de início rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Template Description
configurar o serviço ambientes de implantação

Implantar no Azure
Esse modelo fornece uma maneira de configurar ambientes de implantação.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de devcenters/catálogos pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DevCenter/devcenters/catalogs, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/devcenters/catalogs@2024-02-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      adoGit = {
        branch = "string"
        path = "string"
        secretIdentifier = "string"
        uri = "string"
      }
      gitHub = {
        branch = "string"
        path = "string"
        secretIdentifier = "string"
        uri = "string"
      }
      syncType = "string"
      tags = {
        {customized property} = "string"
      }
    }
  }
}

Valores da propriedade

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
name O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: devcenters
properties Propriedades do catálogo. CatalogProperties
tipo O tipo de recurso "Microsoft.DevCenter/devcenters/catalogs@2024-02-01"

CatalogProperties

Name Description Value
adoGit Propriedades para um tipo de catálogo do Azure DevOps. GitCatalog
gitHub Propriedades de um tipo de catálogo do GitHub. GitCatalog
syncType Indica o tipo de sincronização configurado para o catálogo. 'Manual'
'Scheduled'
tags Tags de recursos. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Branch do Git. cadeia
caminho A pasta em que os itens de catálogo podem ser encontrados dentro do repositório. cadeia
secretIdentifier Uma referência ao segredo do Key Vault que contém um token de segurança para autenticar em um repositório Git. cadeia
uri URI do Git. cadeia

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação do Catálogo do Centro de Desenvolvimento.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "devCenter" {
  type      = "Microsoft.DevCenter/devCenters@2025-02-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${substr(var.resource_name, 0, 22)}-dc"
  location  = var.location
  identity {
    type = "SystemAssigned"
  }
  body = {
    properties = {}
  }
}

resource "azapi_resource" "catalog" {
  type      = "Microsoft.DevCenter/devCenters/catalogs@2025-02-01"
  parent_id = azapi_resource.devCenter.id
  name      = "${substr(var.resource_name, 0, 17)}-catalog"
  body = {
    properties = {
      adoGit = {
        branch           = "main"
        path             = "/template"
        secretIdentifier = "https://amlim-kv.vault.azure.net/secrets/ado/6279752c2bdd4a38a3e79d958cc36a75"
        uri              = "https://amlim@dev.azure.com/amlim/testCatalog/_git/testCatalog"
      }
    }
  }
}