Zajištění agentů pro skupiny nasazení

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Skupina nasazení je logická skupina cílových počítačů nasazení pro klasické vydávací potrubí v Azure Pipelines. Každý cílový server ve skupině nasazení vyžaduje instalaci agenta nasazení. Tento článek vysvětluje, jak nainstalovat a zřídit agenta nasazení na každém fyzickém počítači nebo virtuálním počítači ve skupině nasazení.

Agenta můžete nainstalovat na cílový počítač některým z následujících způsobů:

• Spusťte skript, který se vygeneruje při vytváření skupiny nasazení.
• Nainstalujte na virtuální počítač rozšíření agenta Azure Pipelines.
• Pomocí úlohy nasazení skupiny prostředků Azure v kanálu verze můžete dynamicky vytvořit skupinu nasazení a zřizovat agenty.

Následující části obsahují kroky pro implementaci jednotlivých metod.

Požadavky

• Organizace a projekt Azure DevOps Pokud ho chcete vytvořit, přečtěte si téma Vytvoření nové organizace nebo Vytvoření projektu v Azure DevOps.
• Přístup k alespoň jednomu cílovému počítači s Windows nebo Linuxem s příslušnými oprávněními.
• Pro metodu instalace agenta Azure Pipelines účet Azure a předplatné s oprávněními k vytváření a správě virtuálních počítačů Azure. Pokud nemáte účet Azure, zaregistrujte si bezplatný účet.

Spuštění instalačního skriptu na cílových serverech

Když vytvoříte skupinu nasazení, vygeneruje se skript. Skript můžete spustit na každém cílovém počítači a zaregistrovat server a nainstalovat agenta.

Instalace agenta pomocí vygenerovaného registračního skriptu:

1. V projektu Azure DevOps vyberteskupiny nasazení>.

2. V podokně Skupiny nasazení vyberte Nový nebo vyberte Přidat skupinu nasazení , pokud je tato skupina nasazení první v projektu.

3. Jako název skupiny nasazení zadejte název. Jako popis zadejte volitelný popis. Pak vyberte Vytvořit.

4. V podokně, které se zobrazí, vyberte Windows nebo Linux pro typ cíle, který chcete zaregistrovat. Tato akce vygeneruje registrační skript.

5. Vyberte Použít ve skriptu osobní přístupový token k ověřování. Další informace naleznete v tématu Použití osobních přístupových tokenů.

6. Vyberte Kopírovat skript do schránky.

7. Na každém cílovém počítači se přihlaste pomocí účtu, který má oprávnění správce.

8. Spuštěním zkopírovaného skriptu zaregistrujte počítač a nainstalujte agenta. Pro počítače s Windows použijte příkazový řádek PowerShellu se zvýšenými oprávněními.

9. Při spuštění skriptu:

   • Pokud chcete přiřadit značky, které umožňují omezit nasazení na určité servery v úloze skupiny nasazení, zadejte po zobrazení výzvy k zadání značek Y . Pak zadejte značku nebo značky pro tento virtuální počítač.

     Značky jsou omezené na 256 znaků a nerozlišují malá a velká písmena. Počet značek, které můžete použít, není nijak omezený.

   • Po zobrazení výzvy k zadání uživatelského účtu přijměte výchozí hodnoty.

   Poznámka:

   Pokud při spuštění skriptu dojde k chybě s oznámením, že se nepodařilo vytvořit zabezpečený kanál, spusťte na příkazovém řádku PowerShellu se zvýšenými oprávněními následující příkaz:

   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Po nastavení každého cílového serveru by měl skript vrátit zprávu Service vstsagent.{organization-name}.{computer-name} started successfully.

Na kartě Cíle v podokně Skupiny nasazení Azure Pipelines můžete ověřit, že je agent spuštěný. V případě potřeby stránku aktualizujte.

Instalace rozšíření agenta Azure Pipelines

Pokud jako počítače pro nasazení používáte virtuální počítače Azure, můžete na každý virtuální počítač nainstalovat rozšíření agenta Azure Pipelines. Rozšíření automaticky zaregistruje agenta v zadané skupině nasazení v projektu Azure DevOps.

Pokud chcete agenta nainstalovat pomocí rozšíření, nejprve vytvořte skupinu nasazení:

1. V projektu Azure DevOps vyberteskupiny nasazení>.

2. V podokně Skupiny nasazení vyberte Nový nebo vyberte Přidat skupinu nasazení , pokud je tato skupina nasazení první v projektu.

3. Jako název skupiny nasazení zadejte název. Jako popis zadejte volitelný popis. Pak vyberte Vytvořit.

Na webu Azure Portal nainstalujte na každý cílový virtuální počítač rozšíření agenta Azure Pipelines:

1. Na stránce virtuálního počítače vyberte Nastavení>rozšíření a aplikace.

2. Na kartě Rozšíření vyberte Přidat.

3. V podokně Instalace rozšíření vyhledejte a vyberte agenta Azure Pipelines. Pak vyberte Další.

   

4. V podokně Konfigurace rozšíření agenta Azure Pipelines zadejte následující informace:

   • Adresa URL organizace Azure DevOps: Zadejte adresu URL vaší organizace Azure DevOps, například https://dev.azure.com/contoso.
   • Týmový projekt: Zadejte název projektu, například myProject.
   • Skupina nasazení: Zadejte název skupiny nasazení, kterou jste vytvořili.
   • Název agenta: Volitelně zadejte název agenta. Pokud nic nezadáte, název agenta je název virtuálního počítače připojený pomocí -DG.
   • Osobní přístupový token: Zadejte token PAT (Personal Access Token), který se má použít k ověřování ve službě Azure Pipelines.
   • Značky: Volitelně můžete zadat čárkami oddělený seznam značek, které se mají nakonfigurovat pro agenta. Značky jsou omezené na 256 znaků a nerozlišují malá a velká písmena. Počet značek, které můžete použít, není nijak omezený.

5. Vyberte možnost Zkontrolovat a vytvořit. Po úspěšném ověření vyberte Vytvořit.

Použijte úlohu nasazení skupiny prostředků Azure

Pomocí úlohy nasazení skupiny prostředků Azure můžete nasadit šablonu Azure Resource Manageru (šablonu ARM). Šablona může během vytváření virtuálního počítače Azure nainstalovat rozšíření agenta Azure Pipelines nebo může aktualizovat skupinu prostředků, aby rozšíření po vytvoření virtuálního počítače použila.

Případně můžete použít pokročilé možnosti nasazení úlohy "Azure Resource Group Deployment" k nasazení agenta.

Vytvořte skupinu nasazení

Nejprve vytvořte skupinu nasazení:

1. V projektu Azure DevOps vyberteskupiny nasazení>.

2. Na obrazovce Skupiny nasazení vyberte Nový nebo vyberte Přidat skupinu nasazení, pokud je tato skupina nasazení první v projektu.

3. Jako název skupiny nasazení zadejte název. Jako popis zadejte volitelný popis. Pak vyberte Vytvořit.

Instalace agenta pomocí šablony ARM

Šablona ARM je soubor JSON, který deklarativní definuje sadu prostředků Azure. Azure automaticky přečte šablonu a zřídí prostředky. V jedné šabloně můžete nasadit více služeb a jejich závislosti.

Pokud chcete agenta nasazení zaregistrovat a nainstalovat s využitím šablony ARM, přidejte do resources prostředku prvek Microsoft.Compute/virtualMachine, jak je znázorněno v následujícím kódu.

"resources": [
  {
    "name": "[concat(parameters('vmNamePrefix'),copyIndex(),'/TeamServicesAgent')]",
    "type": "Microsoft.Compute/virtualMachines/extensions",
    "location": "[parameters('location')]",
    "apiVersion": "2015-06-15",
    "dependsOn": [
        "[resourceId('Microsoft.Compute/virtualMachines/',
                      concat(parameters('vmNamePrefix'),copyindex()))]"
    ],
    "properties": {
      "publisher": "Microsoft.VisualStudio.Services",
      "type": "TeamServicesAgent",
      "typeHandlerVersion": "1.0",
      "autoUpgradeMinorVersion": true,
      "settings": {
        "VSTSAccountName": "[parameters('VSTSAccountName')]",
        "TeamProject": "[parameters('TeamProject')]",
        "DeploymentGroup": "[parameters('DeploymentGroup')]",
        "AgentName": "[parameters('AgentName')]",
        "AgentMajorVersion": "auto|2|3",
        "Tags": "[parameters('Tags')]"
      },
      "protectedSettings": {
      "PATToken": "[parameters('PATToken')]"
     }
   }
  }
]

Poznámka:

Ve virtuálním počítači s Linuxem by měl být parametr type pod properties v kódu TeamServicesAgentLinux.

V předchozím kódu:

• VSTSAccountName je organizace Azure Pipelines, kterou je nutné použít. Pokud je například adresa URL Azure DevOps https://dev.azure.com/contoso, zadejte contoso.
• TeamProject je požadovaný projekt, který má v ní definovanou skupinu nasazení.
• DeploymentGroup je nutná skupina nasazení pro registraci agenta.
• AgentName je volitelný název agenta. Pokud není zadaný, název agenta je název virtuálního počítače s připojeným -DG názvem.
• Tags je volitelný seznam značek oddělených čárkami, které se mají nastavit na agentovi. Značky jsou omezené na 256 znaků a nerozlišují malá a velká písmena. Počet značek, které můžete použít, není nijak omezený.
• PATToken je vyžadovaný PAT pro ověření ve službě Azure Pipelines při stahování a konfiguraci agenta.

Další informace o šablonách ARM najdete v tématu Definování prostředků v šablonách Azure Resource Manageru.

Použití šablony ve vydávacím kanálu

Vytvoření vydávacího kanálu:

1. Vyberte Kanály>Verze a pak vyberte Nový>Nový kanál vydání.

2. Na kartě Vydané verze vytvořte vydávací kanál s etapou, která obsahuje úlohu nasazení šablony ARM.

3. Tato šablona používá verzi 2 úlohy, takže v podokně nastavení nasazení skupiny prostředků Azure změňte verzi úlohy z 3.* na 2.*.

4. Zadejte parametry požadované pro úlohu. Zadejte například předplatné Azure, název skupiny prostředků, umístění, informace o šabloně a akci, která se má provést.

5. Uložte potrubí pro vydání a vytvořte vydání z potrubí pro instalaci agentů.

Instalace agenta pomocí rozšířených možností nasazení

Případně můžete agenta nainstalovat pomocí rozšířených možností nasazení. Postupujte podle předchozích kroků pro vytvoření vydávacího kanálu, ale v podokně nastavení skupiny prostředků Azure rozbalte sekci Upřesněné možnosti nasazení pro virtuální počítače. Potom:

1. V části Povolit požadavky vyberte Konfigurovat s agentem skupiny nasazení.

2. Zadejte následující požadované parametry a nastavení:

   • Připojení služby Azure Pipelines: Vyberte existující připojení služby, které odkazuje na váš cíl.

     Pokud nemáte existující připojení ke službě, vyberte Nový a vytvořte ho. Další informace najdete v tématu Vytvoření připojení služby. Nakonfigurujte připojení služby tak, aby používalo PAT s oborem omezeným na Skupinu nasazení.

   • Týmový projekt: Vyberte projekt, který obsahuje skupinu nasazení.

   • Skupina nasazení: Vyberte skupinu nasazení, do které chcete agenty zaregistrovat.

   • Kopírování značek virtuálních počítačů Azure do agentů: Tuto možnost vyberte, pokud chcete zkopírovat všechny značky, které jsou na virtuálním počítači Azure nakonfigurované, do odpovídajícího agenta skupiny nasazení.

     Ve výchozím nastavení se všechny značky Azure zkopírují pomocí Key: Value formátu. Příklad: Role: Web.

3. Uložte pipeline a vytvořte vydání pro instalaci agentů.

Řešení potíží s rozšířením

Existují některé známé problémy s rozšířením agenta Azure Pipelines.

Stavový soubor je příliš velký

Na virtuálních počítačích s Windows obsahuje stavový soubor objekt JSON, který popisuje aktuální stav rozšíření. Objekt je zástupný symbol pro výpis dosud provedených operací.

Azure přečte tento stavový soubor a předá objekt stavu jako odpověď na požadavky rozhraní API. Soubor má maximální povolenou velikost. Pokud velikost překročí maximum, Azure ji nemůže úplně přečíst a zobrazí chybu stavu.

I když se rozšíření může nainstalovat zpočátku, při každém restartování počítače rozšíření provede některé operace, které se připojují k stavovém souboru. Pokud se počítač několikrát restartuje, velikost stavového souboru může překročit prahovou hodnotu. Tato situace způsobí chybu Handler Microsoft.VisualStudio.Services.TeamServicesAgent:1.27.0.2 status file 0.status size xxxxxx bytes is too big. Max Limit allowed: 131072 bytes. I když instalace rozšíření může být úspěšná, tato chyba skryje skutečný stav rozšíření.

Tento problém s restartováním počítače je opravený od verze 1.27.0.2 rozšíření Windows a 1.21.0.1 pro linuxové rozšíření. Restartování teď do stavového souboru nic nepřidává. Pokud jste ale měli tento problém se starší verzí rozšíření a vaše rozšíření se automaticky aktualizovalo na opravenou verzi, může problém trvat. Novější verze rozšíření stále můžou pracovat se starším stavovým souborem.

K tomuto problému může dojít v případě, že existuje jedna z těchto podmínek:

• Používáte starší verzi rozšíření s příznakem, abyste vypnuli automatické aktualizace podverzí.
• Velký stavový soubor byl přesunut ze starší verze na opravenou verzi.

Pokud ano, můžete problém vyřešit odinstalací a opětovnou instalací rozšíření. Odinstalace rozšíření vyčistí celý adresář rozšíření a vytvoří nový stavový soubor pro novou instalaci nejnovější verze.

Vlastní data způsobují problémy při přepínání verzí operačního systému

Python 2 je zastaralý a rozšíření agenta Azure Pipelines funguje s Pythonem 3. Pokud stále používáte verze operačního systému, které nemají ve výchozím nastavení nainstalovaný Python 3, měli byste před spuštěním rozšíření provést jednu z následujících akcí:

• Nainstalujte Python 3 na virtuální počítač.
• Přepněte na verzi operačního systému, která má ve výchozím nastavení nainstalovaný Python 3.

Jinak může vlastní umístění dat na virtuálním počítači způsobit nejasnosti při přepínání verzí operačního systému.

Na virtuálních počítačích s Linuxem se vlastní data zkopírují do /var/lib/waagent/ovf-env.xml starších verzí agenta a do /var/lib/waagent/CustomData novějších verzí. Pokud pevně zakódujete jenom jednu z těchto dvou cest, může přepnutí verzí operačního systému způsobit problémy, protože jedna z cest v nové verzi operačního systému neexistuje, i když je k dispozici druhá cesta. Pokud se chcete vyhnout narušení zřizování virtuálních počítačů, zvažte použití obou cest v šabloně, aby jedna mohla být úspěšná, pokud druhá selže.

Nápověda a podpora

• Projděte si tipy pro řešení potíží.
• Získejte rady o Stack Overflow.
• Zveřejněte své otázky, vyhledejte odpovědi nebo navrhněte funkci v komunitě vývojářů Azure DevOps.
• Získejte podporu pro Azure DevOps.

Související obsah

• Úlohy skupiny nasazení
• Samoobslužní agenti pro Windows
• Samostatně hostovaní agenti pro macOS
• Samohostovaní agenti pro Linux
• Konfigurace a placení paralelních úloh
• Ceny za Azure DevOps