Azure Service Fabric parancssori felület
Az Azure Service Fabric parancssori felület (CLI) egy parancssori eszköz a Service Fabric-entitások használatához és kezeléséhez. A Service Fabric parancssori felület Windows- vagy Linux-fürtökön is használható. A Service Fabric parancssori felület bármilyen platformon fut, amely támogatja a Pythont.
Fontos
A Service Fabrichez két parancssori felületi eszközt lehet használni. Az Azure CLI-vel kezelhetők az Azure-erőforrások, például az Azure-ban tárolt Service Fabric-fürtök. A Service Fabric parancssori felületével közvetlenül a Service Fabric-fürthöz kapcsolódva lehet kezelni a fürtöt, az alkalmazásokat és a szolgáltatásokat (függetlenül attól, hogy a fürt hol található).
Előfeltételek
A telepítés előtt győződjön meg arról, hogy a környezetben a Python és a pip is telepítve van. További információkért olvassa el a pip rövid útmutató dokumentációját és a hivatalos Python-telepítési dokumentációt.
A parancssori felület támogatja a Python 2.7-s és 3.6-os vagy újabb verzióit, és a Python 3.x használata ajánlott.
A Service Fabric cél futtatókörnyezete
A Service Fabric parancssori felület a Service Fabric SDK legfrissebb futtatókörnyezet-verzióját hivatott támogatni. A következő táblázat segítségével határozhatja meg, hogy melyik parancssori felületet telepítse:
| Parancssori felület verziója | támogatott futtatókörnyezet-verzió |
|---|---|
| Legújabb (~=10) | Legújabb (~=7,1) |
| 9.0.0 | 7.1 |
| 8.0.0 | 6.5 |
| 7.1.0 | 6.4 |
| 6.0.0 | 6.3 |
| 5.0.0 | 6,2 |
| 4.0.0 | 6.1 |
| 3.0.0 | 6.0 |
| 1.1.0 | 5.6, 5.7 |
A parancssori felület telepítendő célverzióját úgy is megadhatja, ha a pip install parancsot kiegészíti a ==<version> kifejezéssel. Például az 1.1.0-s verzió esetén a szintaxis a következő:
pip install -I sfctl==1.1.0
Szükség esetén cserélje a pip install parancsot a korábban említett parancsra.
A Service Fabric parancssori felület kiadásaival kapcsolatos további információért tekintse meg a GitHub-dokumentációt.
A pip, a Python és a Service Fabric parancssori felület telepítése
Sokféleképpen telepítheti a pipet és a Pythont a platformra. Itt találja a Python 3 és a pip gyors telepítésének néhány lépését a főbb operációs rendszerekhez.
Windows
Windows 10, Windows Server 2016 és Windows Server 2012 R2 esetén használja a normál telepítési utasításokat. A Python telepítője alapértelmezés szerint a pipet is telepíti.
Nyissa meg a Python hivatalos letöltési oldalát, és töltse le a Python 3.x legújabb kiadását.
Indítsa el a telepítőt.
A parancssor alján válassza a Python 3.x hozzáadása a PATH-hoz lehetőséget.
Válassza az Install Now (Telepítés) lehetőséget, és fejezze be a telepítést.
Most megnyithat egy új parancsablakot, és lekérheti a Python és a pip verzióját.
python --version
pip --version
Ezután futtassa a következő parancsot az Azure Service Fabric PARANCSSORI (sfctl) telepítéséhez és a parancssori felület súgóoldalának megtekintéséhez:
pip install sfctl
sfctl -h
Ubuntu és a Linux Windows alrendszere
A Service Fabric parancssori felületének telepítéséhez futtassa a következő parancsokat:
sudo apt-get install python3
sudo apt-get install python3-pip
pip3 install sfctl
Ezután a telepítést a következő paranccsal tesztelheti:
sfctl -h
Ha egy „parancs nem található” hiba jelenik meg, például a következő:
sfctl: command not found
Ellenőrizze, hogy a ~/.local/bin elérhető-e a $PATH útvonalon:
export PATH=$PATH:~/.local/bin
echo "export PATH=$PATH:~/.local/bin" >> .shellrc
Ha a Linux Windows alrendszerén végzett telepítés nem megfelelő mappaengedélyek miatt meghiúsul, szükség lehet a telepítés újbóli megkísérlésére emelt szintű engedélyekkel:
sudo pip3 install sfctl
Red Hat Enterprise Linux 7.4 (Service Fabric előzetes verzió támogatása)
A Service Fabric PARANCSSORI Red Hatra való telepítéséhez futtassa a következő parancsokat:
sudo yum install -y python38
sudo yum install python38-setuptools
sudo easy_install-3.4 pip
sudo pip3 install sfctl
A telepítés teszteléséhez tekintse meg a Linuxhoz készült Ubuntu és Windows alrendszer című szakaszban ismertetett lépéseket.
MacOS
MacOS rendszeren javasoljuk, hogy a HomeBrew csomagkezelőt használja. Ha a HomeBrew még nincs telepítve, a következő parancs futtatásával telepítse:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Ezután a terminálról telepítse a legújabb Python 3.x, pip és Service Fabric CLI-t az alábbi parancsok futtatásával:
brew install python3
pip3 install sfctl
sfctl -h
A parancssori felület szintaxisa
A parancsok előtagja mindig a következő: sfctl. Az összes használható paranccsal kapcsolatos általános információkért használja az sfctl -h parancsot. Ha egyetlen paranccsal kapcsolatban van szüksége segítségre, használja az sfctl <command> -h parancsot.
A parancsok ismételhető szerkezetűek, és a parancs célja mindig megelőzi a műveletet.
sfctl <object> <action>
Ebben a példában az <object> az <action> művelet célpontja.
Fürt kiválasztása
A műveletek végrehajtása előtt ki kell választania egy fürtöt, amelyhez csatlakozni kíván. A következő parancs futtatásával például kiválaszthatja a testcluster.com nevű fürtöt, és csatlakozhat hozzá:
Figyelmeztetés
Éles környezetben ne használjon nem védett Service Fabric-fürtöket.
sfctl cluster select --endpoint http://testcluster.com:19080
A fürt végpontját http vagy https előtaggal kell ellátni. Tartalmaznia kell a HTTP-átjáróhoz tartozó portot. A port és a cím megegyezik a Service Fabric Explorer URL-címével.
A tanúsítvánnyal védett fürtök esetében megadhat egy PEM-kódolású tanúsítványt. Ez a tanúsítvány megadható egyetlen fájlként vagy egy tanúsítványból és egy kulcsból álló párként. Ha ez az önaláírt tanúsítvány nem rendelkezik hitelesítésszolgáltatói aláírással, a --no-verify beállítás átadásával kerülheti meg a hitelesítésszolgáltatói ellenőrzést.
sfctl cluster select --endpoint https://testsecurecluster.com:19080 --pem ./client.pem --no-verify
További információ: Csatlakozás védett Azure Service Fabric-fürthöz.
Alapszintű műveletek
A fürt kapcsolatadatai több Service Fabric CLI-munkamenetben is megmaradnak. Egy Service Fabric-fürt kiválasztása után bármilyen Service Fabric-parancsot futtathat a fürtön.
A Service Fabric-fürt állapotának lekérdezéséhez például használja az alábbi parancsot:
sfctl cluster health
A parancs az alábbi kimenetet eredményezi:
{
"aggregatedHealthState": "Ok",
"applicationHealthStates": [
{
"aggregatedHealthState": "Ok",
"name": "fabric:/System"
}
],
"healthEvents": [],
"nodeHealthStates": [
{
"aggregatedHealthState": "Ok",
"id": {
"id": "66aa824a642124089ee474b398d06a57"
},
"name": "_Test_0"
}
],
"unhealthyEvaluations": []
}
Tippek és hibaelhárítás
Itt talál néhány javaslatot és tippet a gyakori problémák megoldásához.
Tanúsítvány konvertálása PFX formátumról PEM formátumra
A Service Fabric parancssori felület PEM- (.pem kiterjesztésű) fájlok formájában támogatja az ügyféloldali tanúsítványokat. Ha Windows rendszerből származó PFX-fájlokat lát, át kell alakítania a tanúsítványokat PEM formátumba. A PFX-fájlok PEM-fájlokká történő konvertálásához használja a következő parancsot:
openssl pkcs12 -in certificate.pfx -out mycert.pem -nodes
Ehhez hasonlóan a PEM-fájlok PFX-fájlokká történő konvertálásához a következő parancsot használhatja (itt nem kell jelszót megadnia):
openssl pkcs12 -export -out Certificates.pfx -inkey Certificates.pem -in Certificates.pem -passout pass:''
További információt az OpenSSL-dokumentációban találhat.
Csatlakozási problémák
Egyes műveletek az alábbi üzenetet hozhatják létre:
Failed to establish a new connection
Ellenőrizze, hogy a megadott fürtvégpont elérhető-e és figyel-e. Továbbá ellenőrizze, hogy a Service Fabric Explorer felhasználói felülete elérhető-e a gazdagépen és a porton. A végpont frissítéséhez használja az sfctl cluster select parancsot.
Részletes naplók
A részletes naplók gyakran hasznosak a hibák javításához vagy a problémák jelentéséhez. A --debug jelölő növeli a kimenet részletességét.
Parancsok súgója és szintaxisa
Ha segítségre van szüksége egy bizonyos paranccsal vagy parancscsoporttal kapcsolatban, használja a -h jelzőt.
sfctl application -h
Egy másik példa:
sfctl application create -h
A Service Fabric parancssori felület frissítése
A Service Fabric parancssori felületének frissítéséhez futtassa a következő parancsokat (az eredeti telepítéskor használt paramétertől függően a pip helyett írjon be pip3-at):
pip uninstall sfctl
pip install sfctl
Következő lépések
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: