A fejlesztési környezet beállítása macOS X rendszeren
Azure Service Fabric-alkalmazásokat hozhat létre Linux-fürtökön való futtatáshoz a macOS X használatával. Ez a dokumentum bemutatja, hogyan állíthatja be a Macet a fejlesztéshez.
Előfeltételek
Az Azure Service Fabric nem fut natív módon macOS X rendszeren. Helyi Service Fabric-fürt futtatásához egy előre konfigurált Docker-tárolórendszerképet biztosítunk. Az első lépések előtt a következőkre lesz szüksége:
A Docker Desktop Mac gépen való telepítésének rendszerkövetelményei
Tipp.
A Docker Mac gépen való telepítéséhez kövesse a Docker dokumentációjában ismertetett lépéseket. A telepítés után a Docker Desktop használatával beállíthatja a beállításokat, beleértve az erőforráskorlátokat és a lemezkihasználtságot.
Helyi tároló létrehozása és a Service Fabric beállítása
Egy helyi Docker-tároló beállításához és egy Service Fabric-fürt rajta való futtatásához hajtsa végre a következő lépéseket:
Frissítse a Docker-démon konfigurációját a gazdagépen a következő beállításokkal, és indítsa újra a Docker-démont:
{ "ipv6": true, "fixed-cidr-v6": "fd00::/64" }
Ezeket a beállításokat közvetlenül a Docker telepítési útvonalán található daemon.json fájlban frissítheti. Közvetlenül módosíthatja a démon konfigurációs beállításait a Dockerben. Válassza a Docker ikonját, majd válassza a Preferences (Beállítások)>Daemon (Démon)>Advanced (Speciális) lehetőséget.
Feljegyzés
A démon közvetlenül a Dockerben történő módosítása javasolt, mert a daemon.json fájl helye gépről gépre változhat. Például: ~/Library/Containers/com.docker.docker/Data/database/com.docker.driver.amd64-linux/etc/docker/daemon.json.
Tipp.
Javasoljuk, hogy növelje a Docker számára lefoglalt erőforrásokat nagy méretű alkalmazások tesztelése esetén. Ehhez válassza a Docker ikont, majd a Speciális lehetőséget a magok és a memória számának módosításához.
Indítsa el a fürtöt.
Legkésőbbi:
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:latest
Ubuntu 18.04 LTS:
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18
Tipp.
Alapértelmezés szerint ez a Service Fabric legújabb verziójával rendelkező rendszerképet kéri le. Az egyes változatokért látogasson el a Service Fabric Onebox oldalára a Docker Hubon.
Nem kötelező: Hozza létre a kiterjesztett Service Fabric-rendszerképet.
Hozzon létre egy fájlt egy új könyvtárban, amely a testre szabott rendszerkép létrehozásához hívható
Dockerfile
meg:Feljegyzés
A fenti rendszerképet egy Docker-fájllal módosíthatja, hogy további programokat vagy függőségeket vegyen fel a tárolóba. A
RUN apt-get install nodejs -y
részlet hozzáadása például lehetővé teszi anodejs
-alkalmazások vendég végrehajtható fájlokként való támogatását.FROM mcr.microsoft.com/service-fabric/onebox:u18 RUN apt-get install nodejs -y EXPOSE 19080 19000 80 443 WORKDIR /home/ClusterDeployer CMD ["./ClusterDeployer.sh"]
Tipp.
Alapértelmezés szerint ez a Service Fabric legújabb verziójával rendelkező rendszerképet kéri le. Adott változatokért látogasson el a Docker Hub oldalára.
Az újrahasználható rendszerkép
Dockerfile
létrehozásához nyisson meg egy terminált éscd
a következőt futtatóDockerfile
könyvtárat:docker build -t mysfcluster .
Feljegyzés
Ez a művelet eltarthat egy ideig, de csak egyszer kell végrehajtani.
Most gyorsan elindíthatja a Service Fabric helyi példányát, amikor szüksége van rá a következő futtatásával:
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mysfcluster
Tipp.
Ha megad egy nevet a tárolópéldányhoz, átláthatóbb módon kezelheti.
Ha az alkalmazás bizonyos portokon figyel, a portokat további
-p
címkékkel kell meghatározni. Ha például az alkalmazás a 8080-as porton figyel, adja hozzá az alábbi-p
címkét:docker run -itd -p 19000:19000 -p 19080:19080 -p 8080:8080 --name sfonebox mcr.microsoft.com/service-fabric/onebox:u18
A fürt elindítása eltarthat egy ideig. Amikor fut, a naplókat az alábbi paranccsal tekintheti meg, vagy az irányítópultra ugorva megtekintheti a fürtök állapotát:
http://localhost:19080
docker logs sftestcluster
A tároló leállításához és eltávolításához használja az alábbi parancsot. A következő lépésben azonban ezt a tárolót fogjuk használni.
docker rm -f sftestcluster
Ismert korlátozások
A Mac gép tárolójában futó helyi fürt ismert korlátozásai a következők:
- A DNS-szolgáltatás nem fut, és jelenleg nem támogatott a tárolóban. 132. probléma
- A tárolóalapú alkalmazások futtatásához SF-t kell futtatni linuxos gazdagépen. A beágyazott tárolóalkalmazások jelenleg nem támogatottak.
A Service Fabric parancssori felület (sfctl) beállítása Mac gépen
A Service Fabric parancssori felület (sfctl
) Mac gépre való telepítéséhez kövesse a Service Fabric parancssori felület utasításait.
A parancssori felület parancsai támogatják a Service Fabric-entitásokkal, többek között fürtökkel, alkalmazásokkal és szolgáltatásokkal folytatott interakciók elvégzését.
- Ha csatlakozni szeretne a fürthöz az alkalmazások üzembe helyezése előtt, futtassa az alábbi parancsot.
sfctl cluster select --endpoint http://localhost:19080
Alkalmazás létrehozása Mac gépen a Yeoman használatával
A Service Fabric olyan szerkezetkialakító eszközöket biztosít, amelyekkel Service Fabric-alkalmazásokat hozhat létre a terminálról a Yeoman sablongenerátor használatával. Az alábbi lépések végrehajtásával ellenőrizze, hogy a Service Fabric Yeoman sablongenerátor működik-e a gépen:
Node.js és Node Csomagkezelő telepíteni kell a Mac gépre. A szoftver a HomeBrew használatával, az alábbi módon telepíthető:
brew install node node -v npm -v
Telepítse a Yeoman-sablongenerátort a gépre a Node Csomagkezelő:
npm install -g yo
Telepítse a használni kívánt Yeoman generátort az első lépéseket ismertető dokumentációban leírt lépések végrehajtásával. Service Fabric-alkalmazások Yeomannal való létrehozásához kövesse az alábbi lépéseket:
npm install -g generator-azuresfjava # for Service Fabric Java Applications npm install -g generator-azuresfguest # for Service Fabric Guest executables npm install -g generator-azuresfcontainer # for Service Fabric Container Applications
A generátorok telepítése után hozzon létre futtatható vendégalkalmazásokat vagy tárolószolgáltatásokat a
yo azuresfguest
vagy ayo azuresfcontainer
futtatásával.Service Fabric Java-alkalmazások Mac gépen való létrehozásához a JDK 1.8-as verziójának és a Gradle-nek telepítve kell lennie a gépen. A szoftver a HomeBrew használatával, az alábbi módon telepíthető:
brew update brew cask install java brew install gradle
Fontos
Az aktuális verziók
brew cask install java
a JDK újabb verzióját telepíthetik. Mindenképpen telepítse a JDK 8-at.
Alkalmazás telepítése Mac gépen a terminálból
Miután létrehozta és kiépítette a Service Fabric-alkalmazását, a Service Fabric parancssori felület segítségével helyezheti üzembe:
Csatlakozzon a Mac gépén lévő tárolópéldányon belül futó Service Fabric-fürthöz:
sfctl cluster select --endpoint http://localhost:19080
Futtassa a telepítési szkriptet a projektkönyvtárból:
cd MyProject bash install.sh
.NET Core 3.1-fejlesztés beállítása
Telepítse a Mac.NET Core 3.1 SDK-t A C# Service Fabric-alkalmazások létrehozásához. A .NET Core Service Fabric-alkalmazások csomagjait a NuGet.org üzemelteti.
Az Eclipse-hez készült Service Fabric beépülő modul telepítése Mac gépen
Az Azure Service Fabric biztosítja az Eclipse Neonhoz (vagy újabb kiadáshoz) készült beépülő modult a Java IDE környezethez. A beépülő modul leegyszerűsíti a Java-szolgáltatások létrehozásának, felépítésének és üzembe helyezésének folyamatát. Ha telepíteni szeretné az Eclipse-hez készült Service Fabric beépülő modul legújabb verzióját, vagy frissíteni szeretne a legújabb verzióra, kövesse ezeket a lépéseket. Az Eclipse-hez készült Service Fabric dokumentációjában ismertetett további lépések szintén érvényesek: alkalmazás létrehozása, szolgáltatás hozzáadása egy alkalmazáshoz, alkalmazás eltávolítása stb.
Az utolsó lépés a tároló példányosítása egy a gazdagéppel megosztott elérési út használatával. Ahhoz, hogy a beépülő modul működjön a Mac gép Docker-tárolójával, ilyen típusú példányosításra van szükség. Példa:
docker run -itd -p 19080:19080 -v /Users/sayantan/work/workspaces/mySFWorkspace:/tmp/mySFWorkspace --name sfonebox mcr.microsoft.com/service-fabric/onebox:latest
Az attribútumok a következők:
/Users/sayantan/work/workspaces/mySFWorkspace
a Mac munkaterületének teljes elérési útja./tmp/mySFWorkspace
az útvonal abban a tárolóban, ahová a munkaterület le lesz képezve.
Feljegyzés
Ha más nevet/elérési útvonalat használ a munkaterülethez, frissítse az értékeket a docker run
parancsban.
Ha a tárolót más, az sfonebox
névtől eltérő néven indítja, frissítse a név értéket a Service Fabric-aktor Java alkalmazásában lévő testclient.sh fájlban.
Következő lépések
- Az első Service Fabric Java-alkalmazás létrehozása és üzembe helyezése Linux rendszeren Yeoman használatával
- Az első Service Fabric Java-alkalmazás létrehozása és üzembe helyezése Linux rendszeren az Eclipse-hez készült Service Fabric beépülő modul használatával
- Service Fabric-fürt létrehozása az Azure Portalon
- Service Fabric-fürt létrehozása az Azure Resource Managerrel
- A Service Fabric-alkalmazásmodell megismerése
- A Service Fabric parancssori felület használata az alkalmazások kezeléséhez
- Linux fejlesztőkörnyezet előkészítése Windowson
Visszajelzés
https://aka.ms/ContentUserFeedback.
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ó:Visszajelzés küldése és megtekintése a következőhöz: