Usar un botón de implementación para implementar plantillas desde el repositorio de GitHub
En este artículo se describe cómo usar el botón Implementar en Azure para implementar plantillas desde un repositorio de GitHub. Puede agregar el botón directamente al archivo README.md en el repositorio de GitHub. O bien, puede agregar el botón a una página web que haga referencia al repositorio.
El ámbito de implementación viene determinado por el esquema de plantilla. Para más información, consulte:
Uso de una imagen común
Para agregar el botón a su página web o repositorio, use la siguiente imagen:
<img src="https://aka.ms/deploytoazurebutton"/>
La imagen aparece como:
Crear dirección URL para implementar una plantilla
Para crear la dirección URL de la plantilla, comience con la dirección URL original de la plantilla en el repositorio. Para ver la dirección URL sin formato, seleccione Sin formato.
El formato de la dirección URL es:
https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
A continuación, convierta la dirección URL en un valor con codificación URL. Puede usar un codificador en línea o ejecutar un comando. En el siguiente ejemplo de PowerShell se muestra cómo codificar un valor como una dirección URL.
$url = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json"
[uri]::EscapeDataString($url)
La dirección URL de ejemplo tiene el siguiente valor cuando se codifica como una URL.
https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json
Cada vínculo comienza con la misma dirección URL base:
https://portal.azure.com/#create/Microsoft.Template/uri/
Agregue el vínculo de la plantilla con codificación URL al final de la dirección URL base.
https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json
Ya tiene la dirección URL completa del vínculo.
Nota
Para implementar una plantilla o hacer referencia a una plantilla vinculada que se almacena en un repositorio de GitHub privado, consulte una solución personalizada documentada en un blog de MVP. Puede configurar una función de Azure como proxy para construir la dirección URL necesaria para acceder a un archivo de plantilla en un repositorio de GitHub privado.
Si usa Git con Azure Repos en lugar de un repositorio de GitHub, puede seguir usando el botón Implementar en Azure. Asegúrese de que el repositorio es público. Use la operación Elementos para obtener la plantilla. La solicitud debería tener el siguiente formato:
https://dev.azure.com/{organization-name}/{project-name}/_apis/git/repositories/{repository-name}/items?scopePath={url-encoded-path}&api-version=6.0
Codifique esta dirección URL de solicitud.
Crear el botón Implementar en Azure
Por último, coloque el vínculo y la imagen juntos.
Para agregar el botón con Markdown en el archivo README.md en el repositorio de GitHub o en una página web, use:
[](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json)
Para HTML, use:
<a href="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.storage%2Fstorage-account-create%2Fazuredeploy.json" target="_blank">
<img src="https://aka.ms/deploytoazurebutton"/>
</a>
En el caso de Git con el repositorio de Azure, el botón tiene el siguiente formato:
[](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fdev.azure.com%2Forgname%2Fprojectname%2F_apis%2Fgit%2Frepositories%2Freponame%2Fitems%3FscopePath%3D%2freponame%2fazuredeploy.json%26api-version%3D6.0)
Implementación de la plantilla
Para probar la solución completa, seleccione el botón siguiente:
El portal muestra un panel que le permite proporcionar fácilmente los valores de parámetros. Los parámetros se rellenan previamente con los valores predeterminados de la plantilla. El nombre del parámetro con mayúsculas y minúsculas Camel, storageAccountType, definido en la plantilla se convierte en una cadena separada por espacios cuando se muestra en el portal.
Pasos siguientes
- Para información sobre las plantillas, consulte Nociones sobre la estructura y la sintaxis de las plantillas de ARM.