A fejlesztési környezet beállítása macOS X rendszeren

Cikk
06/01/2023

Az Azure Service Fabric-alkalmazásokat a macOS X használatával hozhatja létre Linux-fürtökön való futtatáshoz. Ez a dokumentum bemutatja, hogyan állíthatja be Mac gépét fejlesztésre.

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 rendszeren való telepítésének rendszerkövetelményei
A Docker Desktop telepítése és futtatása Mac gépen

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 megadhatja 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.

Megjegyzés

A démon közvetlenül a Dockerben történő módosítása ajánlott, 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.

Legújabb:

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 Docker Hub.

Nem kötelező: Hozza létre a kiterjesztett Service Fabric-lemezképet.

Hozzon létre egy nevű Dockerfile fájlt egy új könyvtárban a testre szabott rendszerkép létrehozásához:

Megjegyzés

A fenti képet egy Docker-fájllal is 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 a nodejs-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.

Ha az újrahasználható rendszerképet a Dockerfilefájlból szeretné létrehozni, nyisson meg egy terminált, és cd nyissa meg a következő könyvtárat Dockerfile :
```
docker build -t mysfcluster .
```
Megjegyzé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 következő paranccsal tekintheti meg a naplókat, 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 egy Linux-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 a Node Package Managert telepíteni kell a Mac gépére. 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épére a Node Package Managerből:
```
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 a yo 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

A JDK jelenlegi verziói brew cask install java a JDK újabb verzióját telepíthetik. Mindenképpen telepítse a JDK 8-t.

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ának megkezdéséhez. 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éldául:

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.

Megjegyzé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.