Správa aplikace Azure Service Fabric pomocí Azure Service Fabric CLI (sfctl)
Zjistěte, jak vytvářet a odstraňovat aplikace spuštěné v clusteru Azure Service Fabric.
Požadavky
Nainstalujte Service Fabric CLI. Pak vyberte cluster Service Fabric. Další informace najdete v tématu Začínáme s Rozhraním příkazového řádku Service Fabric.
Připravte balíček aplikace Service Fabric, který je připravený k nasazení. Další informace o tom, jak vytvořit a zabalit aplikaci, najdete v tématu o modelu aplikace Service Fabric.
Přehled
Pokud chcete nasadit novou aplikaci, proveďte následující kroky:
- Nahrajte balíček aplikace do úložiště imagí Service Fabric.
- Zřiďte typ aplikace.
- Odstraňte obsah úložiště obrázků.
- Zadejte a vytvořte aplikaci.
- Zadejte a vytvořte služby.
Pokud chcete odebrat existující aplikaci, proveďte následující kroky:
- Odstraňte aplikaci.
- Zrušte zřízení přidruženého typu aplikace.
Nasazení nové aplikace
Pokud chcete nasadit novou aplikaci, proveďte následující úlohy:
Nahrání nového balíčku aplikace do úložiště imagí
Než vytvoříte aplikaci, nahrajte balíček aplikace do úložiště imagí Service Fabric.
Pokud je například balíček aplikace v app_package_dir adresáři, nahrajte adresář pomocí následujících příkazů:
sfctl application upload --path ~/app_package_dir
U rozsáhlých balíčků aplikací můžete určit --show-progress možnost zobrazení průběhu nahrávání.
Zřízení typu aplikace
Po dokončení nahrávání zřiďte aplikaci. Pokud chcete aplikaci zřídit, použijte následující příkaz:
sfctl application provision --application-type-build-path app_package_dir
Hodnota application-type-build-path je název adresáře, do kterého jste nahráli balíček aplikace.
Odstranění balíčku aplikace
Po úspěšné registraci aplikace doporučujeme odebrat balíček aplikace. Odstranění balíčků aplikací z úložiště imagí uvolní systémové prostředky. Udržování nepoužívaných balíčků aplikací spotřebovává diskové úložiště a vede k problémům s výkonem aplikací.
Pokud chcete odstranit balíček aplikace z úložiště imagí, použijte následující příkaz:
sfctl store delete --content-path app_package_dir
content-path musí být název adresáře, který jste nahráli při vytváření aplikace.
Vytvoření aplikace z typu aplikace
Po zřízení aplikace použijte následující příkaz k pojmenování a vytvoření aplikace:
sfctl application create --app-name fabric:/TestApp --app-type TestAppType --app-version 1.0
app-name je název, který chcete použít pro instanci aplikace. Z dříve zřízeného manifestu aplikace můžete získat další parametry.
Název aplikace musí začínat předponou fabric:/.
Vytvoření služeb pro novou aplikaci
Po vytvoření aplikace vytvořte služby z aplikace. V následujícím příkladu vytvoříme novou bezstavovou službu z naší aplikace. Služby, které můžete vytvořit z aplikace, jsou definovány v manifestu služby v dříve zřízeném balíčku aplikace.
sfctl service create --app-id TestApp --name fabric:/TestApp/TestSvc --service-type TestServiceType \
--stateless --instance-count 1 --singleton-scheme
Ověření nasazení a stavu aplikace
Pokud chcete ověřit, že je všechno v pořádku, použijte následující příkazy stavu:
sfctl application list
sfctl service list --application-id TestApp
Pokud chcete ověřit, že je služba v pořádku, použijte podobné příkazy k načtení stavu služby i aplikace:
sfctl application health --application-id TestApp
sfctl service health --service-id TestApp/TestSvc
Zdravé služby a aplikace mají HealthState hodnotu Ok.
Odebrání existující aplikace
Pokud chcete aplikaci odebrat, proveďte následující úlohy:
Odstranění aplikace
Pokud chcete aplikaci odstranit, použijte následující příkaz:
sfctl application delete --application-id TestEdApp
Zrušení zřízení typu aplikace
Po odstranění aplikace můžete zrušit zřízení typu aplikace, pokud ji už nepotřebujete. Pokud chcete zrušit zřízení typu aplikace, použijte následující příkaz:
sfctl application unprovision --application-type-name TestAppType --application-type-version 1.0
Název typu a verze typu se musí shodovat s názvem a verzí v dříve zřízeném manifestu aplikace.
Upgrade aplikace
Po vytvoření aplikace můžete stejnou sadu kroků zopakovat, abyste zřídili druhou verzi aplikace. Potom s upgradem aplikace Service Fabric můžete přejít na spuštění druhé verze aplikace. Další informace najdete v dokumentaci k upgradům aplikací Service Fabric.
Pokud chcete provést upgrade, nejprve pomocí stejných příkazů jako předtím zřiďte další verzi aplikace:
sfctl application upload --path ~/app_package_dir_2
sfctl application provision --application-type-build-path app_package_dir_2
sfctl store delete --content-path app_package_dir_2
Pak doporučujeme provést monitorovaný automatický upgrade a spustit upgrade spuštěním následujícího příkazu:
sfctl application upgrade --app-id TestApp --app-version 2.0.0 --parameters "{\"test\":\"value\"}" --mode Monitored
Upgrady přepíší existující parametry pomocí zadané sady. Parametry aplikace by měly být v případě potřeby předány jako argumenty příkazu upgrade. Parametry aplikace by měly být kódovány jako objekt JSON.
Pokud chcete načíst všechny parametry, které jste zadali dříve, můžete použít sfctl application info příkaz.
Když probíhá upgrade aplikace, stav lze načíst pomocí sfctl application upgrade-status příkazu.
A konečně, pokud probíhá upgrade a je potřeba ho zrušit, můžete ho použít sfctl application upgrade-rollback k vrácení upgradu zpět.