Rövid útmutató: Üzembe helyezés automatizálása

Feljegyzés

Az Azure Spring Apps az Azure Spring Cloud szolgáltatás új neve. Bár a szolgáltatásnak új neve van, bizonyos helyeken a régi nevet fogja látni egy darabig, miközben az eszközök, például képernyőképek, videók és diagramok frissítésével dolgozunk.

Ez a cikk a következőre vonatkozik:❌ Basic/Standard ✔️ Enterprise

Ez a rövid útmutató bemutatja, hogyan automatizálhatja az Üzembe helyezéseket az Azure Spring Apps Enterprise-csomagban a GitHub Actions és a Terraform használatával.

Előfeltételek

  • Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
  • A Nagyvállalati csomag Követelmények szakaszának megismerése és teljesítése az Azure Marketplace-en.
  • Az Azure CLI 2.45.0-s vagy újabb verziója.
  • Git.
  • jq
  • Az Azure Spring Apps Enterprise csomagbővítménye. A következő paranccsal távolítsa el a korábbi verziókat, és telepítse a legújabb Enterprise-csomagbővítményt. Ha korábban telepítette a spring-cloud bővítményt, távolítsa el a bővítményt a konfiguráció és a verzióeltérések elkerülése érdekében.
    az extension add --upgrade --name spring
    az extension remove --name spring-cloud
    

GitHub-adattár beállítása és hitelesítése

A mintaalkalmazáshoz társított automatizáláshoz egy Storage-fiók szükséges a Terraform állapotának fenntartásához. Az alábbi lépések bemutatják, hogyan hozhat létre tárfiókot a GitHub Actions és a Terraform használatához.

  1. A következő paranccsal hozzon létre egy új erőforráscsoportot a tárfiók tárolásához:

    az group create \
        --name <storage-resource-group> \
        --location <location>
    
  2. Tárfiók létrehozásához használja a következő parancsot:

    az storage account create \
        --resource-group <storage-resource-group> \
        --name <storage-account-name> \
        --location <location> \
        --sku Standard_RAGRS \
        --kind StorageV2
    
  3. A következő paranccsal hozzon létre egy Tárolótárolót a Tárfiókon belül:

    az storage container create \
        --resource-group <storage-resource-group> \
        --name terraform-state-container \
        --account-name <storage-account-name> \
        --auth-mode login
    
  4. Azure-hitelesítő adatok beszerzéséhez használja az alábbi parancsokat. Azure-szolgáltatásnév hitelesítő adataira van szüksége az Azure bejelentkezési művelet engedélyezéséhez.

    az login
    az ad sp create-for-rbac \
        --role contributor \
        --scopes /subscriptions/<SUBSCRIPTION_ID> \
        --json-auth
    

    A parancsnak ki kell kimenete egy JSON-objektumot:

    {
        "clientId": "<GUID>",
        "clientSecret": "<GUID>",
        "subscriptionId": "<GUID>",
        "tenantId": "<GUID>",
        ...
    }
    
  5. Ez a példa a GitHubon található fitnesztár-mintát használja. Fork the sample, open the GitHub repository page, majd select the Gépház tab. Nyissa meg a Titkos kódok menüt, majd válassza a Hozzáadás új titkos kulcs, ahogy az alábbi képernyőképen látható.

    Screenshot showing GitHub Settings Add new secret.

  6. Állítsa be a titkos kód nevét AZURE_CREDENTIALS a GitHub-adattár beállítása és hitelesítése című címsorban található JSON-sztringre, és állítsa be annak értékét.

    Screenshot showing GitHub Settings Set secret data.

  7. Adja hozzá a következő titkos kódokat a GitHub Actionshez:

  8. Adja hozzá a titkos kulcsot TF_BACKEND_CONFIG a GitHub Actionshez a következő értékkel:

    resource_group_name  = "<storage-resource-group>"
    storage_account_name = "<storage-account-name>"
    container_name       = "terraform-state-container"
    key                  = "dev.terraform.tfstate"
    

Automatizálás a GitHub Actions használatával

Most már futtathatja a GitHub Actionst az adattárban. A kiépítési munkafolyamat a példaalkalmazás futtatásához szükséges összes erőforrást kiosztja. Az alábbi képernyőképen egy példafuttatás látható:

Screenshot of GitHub showing output from the provision workflow.

Minden alkalmazás rendelkezik egy üzembe helyezési munkafolyamatsal , amely újra üzembe helyezi az alkalmazást az adott alkalmazás módosításakor. Az alábbi képernyőképen a katalógusszolgáltatás néhány példakimenete látható:

Screenshot of GitHub showing output from the Deploy Catalog workflow.

A karbantartási munkafolyamat manuálisan futtatható a munkafolyamat által provision létrehozott összes erőforrás törléséhez. Az alábbi képernyőképen a kimenet látható:

Screenshot of GitHub showing output from the cleanup workflow.

Az erőforrások eltávolítása

Ha további rövid útmutatókkal és oktatóanyagokkal szeretne dolgozni, érdemes lehet ezeket az erőforrásokat a helyén hagyni. Ha már nincs rá szükség, törölje az erőforráscsoportot, amely törli az erőforráscsoport erőforrásait. Ha törölni szeretné az erőforráscsoportot az Azure CLI használatával, használja a következő parancsokat:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Következő lépések

Folytassa az alábbi rövid útmutatók bármelyikével: