Připojení k instanci aplikace pro řešení potíží

Poznámka:

Plány Basic, Standard a Enterprise budou od poloviny března 2025 vyřazeny ze 3letého období vyřazení. Doporučujeme přejít na Azure Container Apps. Další informace najdete v oznámení o vyřazení Azure Spring Apps.

Od 30. září 2024 bude od 30. září 2024 zastaralý plán s úplným vypnutím po šesti měsících. Doporučujeme přejít na Azure Container Apps. Další informace najdete v tématu Migrace spotřeby Azure Spring Apps Úrovně Standard a vyhrazeného plánu do Azure Container Apps.

Tento článek se vztahuje na:✅ Basic/Standard ✅ Enterprise

Tento článek popisuje, jak přistupovat k prostředí prostředí v instancích vaší aplikace a provádět pokročilé řešení potíží.

Přestože Azure Spring Apps nabízí různé spravované přístupy pro řešení potíží, možná budete chtít provádět pokročilé řešení potíží pomocí prostředí prostředí. Můžete například chtít provést následující úlohy řešení potíží:

• Přímo používejte nástroje Sady Java Development Kit (JDK).
• Diagnostika back-endových služeb aplikace pro síťové připojení a latenci volání rozhraní API pro instance virtuální sítě i jiné než virtuální sítě
• Diagnostika problémů s kapacitou úložiště, výkonem a procesorem a pamětí

Požadavky

• Azure CLI s rozšířením Azure Spring Apps Pomocí následujícího příkazu odeberte předchozí verze a nainstalujte nejnovější rozšíření. Pokud jste rozšíření nainstalovali dříve spring-cloud , odinstalujte ho, abyste se vyhnuli neshodám konfigurace a verzí.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• Nasazená aplikace v Azure Spring Apps

• Pokud jste nasadili vlastní kontejner, program prostředí. Výchozí hodnota je /bin/sh.

Přiřazení role Azure

Před připojením k instanci aplikace musíte mít udělenou roli Azure Spring Apps Connect. Připojení k instanci aplikace vyžaduje oprávnění Microsoft.AppPlatform/Spring/apps/deployments/connect/actionakce dat .

Roli Azure můžete přiřadit pomocí webu Azure Portal nebo Azure CLI.

Azure Portal

Pomocí následujícího postupu přiřaďte roli Azure pomocí webu Azure Portal.

1. Otevřete Azure Portal.

2. Otevřete existující instanci služby Azure Spring Apps.

3. V nabídce vlevo vyberte Řízení přístupu (IAM ).

4. Na panelu příkazů vyberte Přidat a pak vyberte Přidat přiřazení role.

   

5. V seznamu vyhledejte roli Azure Spring Apps Connect a pak vyberte Další.

   

6. Vyberte vybrat členy a vyhledejte své uživatelské jméno.

7. Vyberte Zkontrolovat + přiřadit.

Azure CLI

Pomocí následujícího příkazu přiřaďte roli role Azure Spring Apps Connect pomocí Azure CLI:

az role assignment create \
    --role 'Azure Spring Apps Connect Role' \
    --scope '<service-instance-resource-id>' \
    --assignee '<your-identity>'

Poznámka:

Přiřazení role může trvat několik minut.

Připojení k instanci aplikace

K instanci aplikace se můžete připojit pomocí webu Azure Portal nebo Azure CLI.

Azure Portal

Pomocí následujících kroků se připojte k instanci aplikace pomocí webu Azure Portal.

1. Otevřete Azure Portal.

2. Otevřete existující instanci služby Azure Spring Apps.

3. V nabídce vlevo vyberte Aplikace a pak vyberte jednu z vašich aplikací.

4. V nabídce vlevo vyberte konzolu .

5. Vyberte instanci aplikace.

   

6. Vyberte nebo zadejte prostředí, které se má spustit v kontejneru.

   

7. Vyberte Připojit.

   

Azure CLI

Pokud vaše aplikace obsahuje jenom jednu instanci, pomocí následujícího příkazu se připojte k instanci pomocí Azure CLI:

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name>

V opačném případě pomocí následujícího příkazu zadejte instanci:

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --instance <instance_name>

K určení jiného nasazení aplikace použijte následující příkaz:

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --deployment green

Azure Spring Apps ve výchozím nastavení spustí instanci aplikace se /bin/sh sadou v základní imagi kontejneru. Pomocí následujícího příkazu přepněte do jiného sbaleného prostředí, například /bin/bash:

az spring app connect \
    --service <your-service-instance> \
    --resource-group <your-resource-group> \
    --name <app-name> \
    --shell-cmd /bin/bash

Pokud je vaše aplikace nasazená s vlastní imagí a prostředím, můžete k určení prostředí použít --shell-cmd také parametr.

Řešení potíží s instancí aplikace

Po připojení k instanci aplikace můžete zkontrolovat stav paměti haldy.

Pomocí následujícího příkazu vyhledejte ID procesu Java, což je obvykle 1:

jps

Výstup by měl vypadat jako v následujícím příkladu:

Potom pomocí následujícího příkazu spusťte nástroj JDK a zkontrolujte výsledek:

jstat -gc 1

Výstup by měl vypadat jako v následujícím příkladu:

Odpojení od instance aplikace

Až budete s řešením potíží hotovi, pomocí exit příkazu se odpojte od instance aplikace nebo stiskněte .Ctrl+d

Nástroje pro řešení potíží

Následující seznam popisuje některé předinstalované nástroje, které můžete použít k řešení potíží:

• lsof - Vypíše otevřené soubory.
• top - Zobrazí souhrnné informace o systému a aktuální využití.
• ps – Získá snímek spuštěného procesu.
• netstat - Vytiskne síťová připojení a statistiky rozhraní.
• nslookup – Interaktivně se dotazuje na názvové servery internetu.
• ping – Otestuje, jestli je možné dosáhnout síťového hostitele.
• nc - Čte ze síťových připojení a zápisů pomocí protokolu TCP nebo UDP.
• wget – Umožňuje stahovat soubory a pracovat s rozhraními REST API.
• df – Zobrazí množství volného místa na disku.

Můžete také použít nástroje sady JDK, jako jpsjsou , jcmda jstat.

Následující seznam obsahuje dostupné nástroje, které závisí na vašem plánu služby a typu nasazení aplikace:

• Nasazení zdrojového kódu, jar a artefaktů:
  • Plán Basic, Standard a Standard Consumption & Dedicated:
    • Běžné nástroje – Ano
    • Nástroje JDK – Ano, pouze pro úlohy v Javě
  • Plán Enterprise:
    • Běžné nástroje – závisí na tom, který zásobník operačního systému jste zvolili ve svém tvůrci. Ano, pro plný zásobník operačního systému. Ne, pro základní zásobník operačního systému.
    • Nástroje JDK – Ano, pouze pro úlohy v Javě
• Nasazení vlastní image: Závisí na nainstalované sadě nástrojů v imagi.

Poznámka:

Nástroje sady JDK nejsou součástí cesty pro typ nasazení zdrojového kódu . Před spuštěním jakýchkoli příkazů sady JDK spusťte export PATH="$PATH:/layers/tanzu-buildpacks_microsoft-openjdk/jdk/bin" příkazy.

Omezení

Použití prostředí v instancích vaší aplikace má následující omezení:

• Vzhledem k tomu, že aplikace běží jako uživatel, který není root, nemůžete spustit některé akce vyžadující oprávnění uživatele root. Nemůžete například nainstalovat nové nástroje pomocí správce apt / yumsystémových balíčků .

• Některé funkce Linuxu jsou zakázány, a proto nástroje, které vyžadují speciální oprávnění, například tcpdumpnefungují.

Další kroky

• Samodiagnostika a řešení problémů ve službě Azure Spring Apps