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.

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 3.6-os verzióit, és a Python 3.x 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:

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.

1. Nyissa meg a Python hivatalos letöltési oldalát, és töltse le a Python 3.x legújabb kiadását.

2. Indítsa el a telepítőt.

3. A parancssor alján válassza a Python 3.x hozzáadása a PATH-hoz lehetőséget.

4. 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 PARANCSSOR (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 PARANCSSOR 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 lépéseit

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 telepítse a terminálról a legújabb Python 3.x, pip és Service Fabric PARANCSSOR-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á:

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

• Alkalmazás üzembe helyezése az Azure Service Fabric parancssori felülettel
• A Service Fabric használatának első lépései Linuxon