Naslaginformatie over CLI-variabelen in Azure Deployment Environment

Azure Deployment Environments (ADE) stelt veel variabelen in met betrekking tot uw omgeving waarnaar u kunt verwijzen tijdens het ontwerpen van aangepaste installatiekopieën. U kunt de onderstaande variabelen in de bewerkingsscripts (deploy.sh of delete.sh) gebruiken om uw afbeeldingen flexibel te maken voor de omgeving waarmee ze communiceren.

Voor bestanden die door ADE in de container worden gebruikt, bevinden alle bestanden zich in een ade submap van de oorspronkelijke map.

Hier volgt de lijst met beschikbare omgevingsvariabelen:

ADE_ERROR_LOG

Verwijst naar het bestand in /ade/temp/error.log. In error.log het bestand worden standaardfoutuitvoer opgeslagen die de foutdetails van een omgeving vult in het resultaat van een mislukte implementatie of verwijdering. Het bestand wordt gebruikt met ade execute, waarmee alle standaarduitvoer en standaardfoutinhoud worden vastgelegd in een door ADE beheerd logboekbestand. Wanneer u de ade execute opdracht gebruikt, leidt u standaardfoutlogboekregistratie om naar deze bestandslocatie met behulp van de volgende opdracht:

ade execute --operation $ADE_OPERATION_NAME --command "{YOUR_COMMAND}" 2> >(tee -a $ADE_ERROR_LOG)

Met deze methode kunt u de implementatie- of verwijderingsfout in de ontwikkelaarsportal bekijken. Dit leidt tot snellere en succesvollere iteraties bij het maken van uw aangepaste installatiekopieën en een snellere diagnose van de hoofdoorzaak voor de mislukte bewerking.

ADE_OUTPUTS

Verwijst naar het bestand in /ade/temp/output.json. In output.json het bestand worden uitvoer van de implementatie van een omgeving opgeslagen in permanente opslag, zodat deze op een later moment toegankelijk is met behulp van de Azure CLI. Wanneer u de uitvoer opslaat in een aangepaste afbeelding, moet u ervoor zorgen dat de uitvoer wordt geüpload naar het opgegeven bestand, zoals wordt weergegeven in het volgende voorbeeld:

echo "$deploymentOutput" > $ADE_OUTPUTS

ADE_STORAGE

Verwijst naar de map in /ade/storage. Tijdens het ingangspunt van de kerninstallatiekopie haalt ADE een speciaal benoemd storage.zip bestand op uit de opslagcontainer van de omgeving en vult deze map, waarna de map na voltooiing van de bewerking opnieuw wordt geladen als een zip-bestand naar de opslagcontainer. Als u bestanden hebt waarnaar u in uw aangepaste installatiekopie wilt verwijzen bij latere herindelingen, zoals statusbestanden, plaatst u deze in deze map.

ADE_CLIENT_ID

Verwijst naar de object-id van de Managed Service Identity (MSI) van het projectomgevingstype van de omgeving. Deze variabele kan worden gebruikt om te valideren bij de Azure CLI voor machtigingen die binnen de container kunnen worden gebruikt, zoals de implementatie van de infrastructuur.

ADE_TENANT_ID

Verwijst naar de tenant-GUID van de omgeving.

ADE_SUBSCRIPTION_ID

Verwijst naar de abonnements-GUID van de omgeving.

ADE_TEMPLATE_FILE

Verwijst naar de locatie waar het hoofdsjabloonbestand dat is opgegeven in de eigenschap templatePath in de omgevingsdefinitie zich in de container bevindt. Dit pad weerspiegelt ongeveer het broncodebeheer van waar de catalogus zich bevindt, afhankelijk van het bestandspadniveau waarop u de catalogus hebt verbonden. Het bestand bevindt zich ongeveer op /ade/repository/{CATALOG_NAME}/{PATH_TO_TEMPLATE_FILE}. Deze methode wordt voornamelijk gebruikt tijdens de hoofdimplementatiestap als het bestand waarnaar wordt verwezen om de implementatie uit te zetten.

Hier volgt een voorbeeld met behulp van de Azure CLI:

az deployment group create --subscription $ADE_SUBSCRIPTION_ID \
    --resource-group "$ADE_RESOURCE_GROUP_NAME" \
    --name "$deploymentName" \
    --no-prompt true --no-wait \
    --template-file "$ADE_TEMPLATE_FILE" \
    --parameters "$deploymentParameters" \
    --only-show-errors

Alle andere bestanden, zoals het ondersteunen van IaC-bestanden of bestanden die u wilt gebruiken in uw aangepaste installatiekopie, worden op hun relatieve locatie opgeslagen in het sjabloonbestand in de container zoals ze zich in de catalogus bevinden. Neem bijvoorbeeld de volgende map:

├───SampleCatalog
   ├───EnvironmentDefinition1
      │   file1.bicep
      │   main.bicep
      │   environment.yaml
      │
      └───TestFolder
              test1.txt
              test2.txt

In dit geval, $ADE_TEMPLATE_FILE=/ade/repository/SampleCatalog/EnvironmentDefinition1/main.bicep. Daarnaast bevinden bestanden zoals file1.bicep zich in de container op /ade/repository/SampleCatalog/EnvironmentDefinition1/file1.bicep, en test2.txt zich op /ade/repository/SampleCatalog/EnvironmentDefinition1/TestFolder/test2.txt.

ADE_ENVIRONMENT_NAME

De naam van de omgeving die tijdens de implementatie is opgegeven.

ADE_ENVIRONMENT_LOCATION

De locatie waar de omgeving wordt geïmplementeerd. Deze locatie is de regio van het project.

ADE_RESOURCE_GROUP_NAME

De naam van de resourcegroep die door ADE is gemaakt om uw resources te implementeren.

ADE_ENVIRONMENT_TYPE

De naam van het projectomgevingstype dat wordt gebruikt om deze omgeving te implementeren.

ADE_OPERATION_PARAMETERS

Een JSON-object van de parameters die zijn opgegeven om de omgeving te implementeren. Een voorbeeld van het parameterobject volgt:

{
    "location": "locationInput",
    "name": "nameInput",
    "sampleObject": {
        "sampleProperty": "sampleValue"
    },
    "sampleArray": [
        "sampleArrayValue1",
        "sampleArrayValue2"
    ]
}

ADE_OPERATION_NAME

Het type bewerking dat wordt uitgevoerd op de omgeving. Tegenwoordig is deze waarde 'implementeren' of 'verwijderen'.

ADE_HTTP__OPERATIONID

De bewerkings-id die is toegewezen aan de bewerking die wordt uitgevoerd in de omgeving. De bewerkings-id wordt gebruikt als validatie voor het gebruik van de ADE CLI en is de belangrijkste id bij het ophalen van logboeken uit eerdere bewerkingen.

ADE_HTTP__DEVCENTERID

De Ontwikkelaarscentrum-id van de omgeving. De Ontwikkelaarscentrum-id wordt ook gebruikt als validatie om de ADE CLI te gebruiken.