Správa aplikace Azure Service Fabric pomocí azure Service Fabric CLI (sfctl)
Naučte se vytvářet a odstraňovat aplikace, které běží 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 k nasazení. Další informace o tom, jak vytvořit a zabalit aplikaci, najdete v článku o aplikačním modelu Service Fabric.
Přehled
Pokud chcete nasadit novou aplikaci, proveďte tyto 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 tyto 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í
Před vytvořením aplikace nahrajte balíček aplikace do úložiště imagí Service Fabric.
Pokud je například balíček aplikace v adresáři app_package_dir
, použijte k nahrání adresáře následující příkazy:
sfctl application upload --path ~/app_package_dir
U velkých balíčků aplikací můžete zadat --show-progress
možnost pro zobrazení průběhu nahrávání.
Zřízení typu aplikace
Po dokončení nahrávání zřiďte aplikaci. Ke zřízení aplikace použijte následující příkaz:
sfctl application provision --application-type-build-path app_package_dir
Hodnota pro 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 balíček aplikace odebrat. Odstranění balíčků aplikací z úložiště imagí uvolní systémové prostředky. Zachování nepoužívaných balíčků aplikací spotřebovává diskové úložiště a vede k problémům s výkonem aplikace.
K odstranění balíčku 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 z aplikace služby. V následujícím příkladu vytvoříme z naší aplikace novou bezstavovou službu. 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í stavu a nasazení 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
Služby a aplikace, které jsou v pořádku, HealthState
mají hodnotu Ok
.
Odebrání existující aplikace
Pokud chcete aplikaci odebrat, proveďte následující úlohy:
Odstranění aplikace
K odstranění aplikace 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 už ho 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 a verze typu musí odpovídat názvu a verzi v dříve zřízeném manifestu aplikace.
Upgrade aplikace
Po vytvoření aplikace můžete opakovat stejnou sadu kroků a zřídit druhou verzi aplikace. Po upgradu aplikace Service Fabric pak 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 zřiďte další verzi aplikace pomocí stejných příkazů jako předtím:
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 se doporučuje 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řepisují existující parametry libovolnou zadanou sadou. V případě potřeby by se parametry aplikace měly předat jako argumenty příkazu pro upgrade. Parametry aplikace by měly být kódované jako objekt JSON.
K načtení dříve zadaných parametrů můžete použít sfctl application info
příkaz .
Když probíhá upgrade aplikace, je možné stav načíst pomocí sfctl application upgrade-status
příkazu .
Pokud upgrade probíhá a je potřeba ho zrušit, můžete k vrácení upgradu použít sfctl application upgrade-rollback
příkaz .