Share via

Oktatóanyag: Tárolók csomagolása és üzembe helyezése Service Fabric-alkalmazásként a Yeoman használatával

  • Cikk

Ez az oktatóanyag egy sorozat második része. Az oktatóanyag azt ismerteti, hogyan lehet létrehozni Service Fabric-alkalmazásdefiníciót egy sablonkészítő eszközzel (Yeoman). Az alkalmazással ezután tárolókat helyezhet üzembe a Service Fabric rendszerében. Ezen oktatóanyag segítségével megtanulhatja a következőket:

  • A Yeoman telepítése
  • Alkalmazáscsomag létrehozása a Yeoman használatával
  • Az alkalmazáscsomag beállításainak konfigurálása a tárolókkal való használathoz
  • Az alkalmazás létrehozása
  • Az alkalmazás üzembe helyezése és futtatása
  • Az alkalmazás fölösleges elemeinek az eltávolítása

Előfeltételek

  • Az Azure Container Registrybe leküldött, az oktatóanyag-sorozat 1. részében létrehozott tárolórendszerképek.
  • Beállított Linux fejlesztési környezet.

A Yeoman telepítése

A Service Fabric olyan szerkezetkialakító eszközöket biztosít, amelyekkel 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 rendelkezik-e Yeoman sablongenerátorral.

  1. Telepítse a nodejs és a Node Package Manager eszközt a gépére. MacOS X használata esetén a Homebrew csomagkezelőt kell használnia.

    curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash
nvm install node

  2. Telepítse a Yeoman-sablongenerátort a gépére a Node Package Managerből:

    npm install -g yo

  3. Telepítse a Service Fabric Yeoman tárológenerátort.

    npm install -g generator-azuresfcontainer

Docker-rendszerképtároló becsomagolása a Yeomannal

  1. Service Fabric-tárolóalkalmazás létrehozásához futtassa a következő parancsot a klónozott adattár „container-tutorial” könyvtárában.

    yo azuresfcontainer

  2. Adja meg a „TestContainer” nevet az alkalmazás neveként.

  3. Adja meg az „azurevotefront” nevet az alkalmazásszolgáltatás neveként.

  4. Adja meg az előtérbeli adattár tárolólemezképének elérési útját az ACR-ben – például "acrName.azurecr.io/azure-vote-front:v1>"<. Az acrName <> mezőnek meg kell egyeznie az előző oktatóanyagban használt értékkel.

  5. Nyomja le az Enter billentyűt, hogy a Parancsok szakasz üres maradjon.

  6. A példányszám legyen 1.

A yo parancs futtatásának bemenete és kimenete az alábbiak szerint fog kinézni:

? Name your application TestContainer
? Name of the application service: azurevotefront
? Input the Image Name: <acrName>.azurecr.io/azure-vote-front:v1
? Commands:
? Number of instances of guest container application: 1
   create TestContainer/TestContainer/ApplicationManifest.xml
   create TestContainer/TestContainer/azurevotefrontPkg/ServiceManifest.xml
   create TestContainer/TestContainer/azurevotefrontPkg/config/Settings.xml
   create TestContainer/TestContainer/azurevotefrontPkg/code/Dummy.txt
   create TestContainer/install.sh
   create TestContainer/uninstall.sh

Ha egy másik tárolószolgáltatást szeretne hozzáadni a Yeoman használatával már létrehozott alkalmazáshoz, hajtsa végre az alábbi lépéseket:

  1. Módosítsa a könyvtár első szintjét a TestContainer könyvtárra, például ./TestContainer
  2. Az yo azuresfcontainer:AddService parancs futtatása
  3. Adja a szolgáltatásnak az „azurevoteback” nevet.
  4. Adja meg a Redis tárolólemezképének elérési útját – "redis:alpine"
  5. Nyomja le az Enter billentyűt, hogy a Parancsok szakasz üres maradjon.
  6. Adja meg az „1” példányszámát.

A használt szolgáltatás hozzáadásának bejegyzései:

? Name of the application service: azurevoteback
? Input the Image Name: redis:alpine
? Commands:
? Number of instances of guest container application: 1
   create TestContainer/azurevotebackPkg/ServiceManifest.xml
   create TestContainer/azurevotebackPkg/config/Settings.xml
   create TestContainer/azurevotebackPkg/code/Dummy.txt

Az oktatóanyag fennmaradó részében a TestContainer könyvtárban fogunk dolgozni. Például: ./TestContainer/TestContainer. A könyvtár tartalmának az alábbinak kell lennie.

$ ls
ApplicationManifest.xml azurevotefrontPkg azurevotebackPkg

Az alkalmazásjegyzék konfigurálása az Azure Container Registry hitelesítő adataival

Ahhoz, hogy a Service Fabric le tudja kérni a tárolórendszerképeket az Azure Container Registryből, meg kell adnia a hitelesítő adatokat az ApplicationManifest.xml fájlban.

Jelentkezzen be az ACR-példányba. Használja az az acr login parancsot a művelet befejezéséhez. Adja meg a tárolóregisztrációs adatbázis egyedi nevét, amelyet a létrehozásakor adott meg.

az acr login --name <acrName>

A parancs a Bejelentkezés sikeres üzenetet adja vissza, ha befejeződött.

Ezután futtassa a következő parancsot a tárolóregisztrációs adatbázis jelszavának lekéréséhez. A Service Fabric ezt a jelszót használja ahhoz, hogy hitelesíteni tudjon az ACR-rel, és le tudja kérni a tárolórendszerképeket.

az acr credential show -n <acrName> --query passwords[0].value

Az ApplicationManifest.xml fájlban adja a kódrészletet a kezelőfelületi szolgáltatás ServiceManifestImport eleméhez. Illessze be az acrName nevét az AccountName mezőbe. A rendszer a Jelszó mezőben az előző parancs által visszaadott jelszót használja. A dokumentum végén talál egy teljes ApplicationManifest.xml fájlt.

<Policies>
  <ContainerHostPolicies CodePackageRef="Code">
    <RepositoryCredentials AccountName="<acrName>" Password="<password>" PasswordEncrypted="false"/>
  </ContainerHostPolicies>
</Policies>

A kommunikáció és a tárolóport–gazdagépport hozzárendelés konfigurálása

Kommunikációs port konfigurálása

Konfiguráljon egy olyan HTTP-végpontot, amelyen az ügyfelek kommunikálhatnak a szolgáltatással. Nyissa meg a ./TestContainer/azurevotefrontPkg/ServiceManifest.xml fájlt, és adjon meg egy végponterőforrást a ServiceManifest elemben. Adja hozzá a protokoll, a port és a név adatokat. Ebben az oktatóanyagban a szolgáltatás a 80-as portot figyeli. Az alábbi kódrészlet a ServiceManifest címke alá kerül az erőforrásban.

<Resources>
  <Endpoints>
    <!-- This endpoint is used by the communication listener to obtain the port on which to 
            listen. Please note that if your service is partitioned, this port is shared with 
            replicas of different partitions that are placed in your code. -->
    <Endpoint Name="azurevotefrontTypeEndpoint" UriScheme="http" Port="80" Protocol="http"/>
  </Endpoints>
</Resources>

A háttérszolgáltatás szolgáltatásjegyzékét is módosítsa. Nyissa meg a ./TestContainer/azurevotebackPkg/ServiceManifest.xml fájlt, és adjon meg egy végponterőforrást a ServiceManifest elemben. Ebben az oktatóanyagban megmarad a Redis alapértelmezett 6379-es értéke. Az alábbi kódrészlet a ServiceManifest címke alá kerül az erőforrásban.

<Resources>
  <Endpoints>
    <!-- This endpoint is used by the communication listener to obtain the port on which to 
            listen. Please note that if your service is partitioned, this port is shared with 
            replicas of different partitions that are placed in your code. -->
    <Endpoint Name="azurevotebackTypeEndpoint" Port="6379" Protocol="tcp"/>
  </Endpoints>
</Resources>

Az UriScheme megadásával a tároló végpontja automatikusan regisztrálva lesz a Service Fabric elnevezési szolgáltatásban, így felderíthető lesz. A cikk végén talál egy például szolgáló teljes ServiceManifest.xml fájlt a háttérszolgáltatáshoz.

Tárolóportok leképezése egy szolgáltatáshoz

Ahhoz, hogy elérhetővé tegye a tárolókat a fürt számára, egy portkötést is létre kell hoznia az „ApplicationManifest.xml” fájlban. A PortBinding szabályzat a ServiceManifest.xml fájlokban meghatározott végpontokra hivatkozik. Az ezen végpontokra érkező kérések az itt megnyitott és lekötött tárolóportokra lesznek leképezve. Az ApplicationManifest.xml fájlban adja meg a következő kódot, hogy a 80-as és a 6379-es portot a végpontokhoz kösse. A dokumentum végén talál egy teljes ApplicationManifest.xml fájlt.

<ContainerHostPolicies CodePackageRef="Code">
    <PortBinding ContainerPort="80" EndpointRef="azurevotefrontTypeEndpoint"/>
</ContainerHostPolicies>

<ContainerHostPolicies CodePackageRef="Code">
    <PortBinding ContainerPort="6379" EndpointRef="azurevotebackTypeEndpoint"/>
</ContainerHostPolicies>

DNS-név hozzáadása a háttérszolgáltatáshoz

Ahhoz, hogy a Service Fabric ezt a DNS-nevet a háttérszolgáltatáshoz rendelje, meg kell adni a nevet az ApplicationManifest.xml fájlban. Adja a ServiceDnsName attribútumot a Service elemhez az itt látható módon:

<Service Name="azurevoteback" ServiceDnsName="redisbackend.testapp">
  <StatelessService ServiceTypeName="azurevotebackType" InstanceCount="1">
    <SingletonPartition/>
  </StatelessService>
</Service>

A kezelőfelületi szolgáltatás beolvas egy környezeti változót, hogy megtudja a Redis-példány DNS-nevét. Ez a környezeti változó már meg van határozva a Docker-rendszerkép létrehozásához használt Docker-fájlban, így külön műveletet nem kell elvégezni.

ENV REDIS redisbackend.testapp

A következő kódrészletet bemutatja, hogyan szerzi be az előtérbeli Python-kód a Docker-fájlban leírt környezeti változót. Ehhez nem kell külön műveletet elvégezni.

# Get DNS Name
redis_server = os.environ['REDIS']

# Connect to the Redis store
r = redis.StrictRedis(host=redis_server, port=6379, db=0)

Az oktatóanyag ezen pontján üzembe lehet helyezni egy szolgáltatáscsomag-alkalmazás sablonját a fürtön. A következő oktatóanyagban ezt az alkalmazást fogjuk üzembe helyezni és futtatni egy Service Fabric-fürtben.

Service Fabric-fürt létrehozása

Ha az alkalmazást üzembe szeretné helyezni az Azure-ban, szüksége lesz egy Service Fabric-fürtre a futtatásához. Az alábbi parancsok egy ötcsomópontos fürtöt hoznak létre az Azure-ban. A parancsok önaláírt tanúsítványt is létrehoznak, hozzáadják egy kulcstartóhoz, és helyileg PEM-fájlként töltik le a tanúsítványt. Az új tanúsítvány a fürt védelmére szolgál az üzembe helyezéskor, és az ügyfelek hitelesítésére szolgál.

#!/bin/bash

# Variables
ResourceGroupName="containertestcluster" 
ClusterName="containertestcluster" 
Location="eastus" 
Password="q6D7nN%6ck@6" 
Subject="containertestcluster.eastus.cloudapp.azure.com" 
VaultName="containertestvault" 
VmPassword="Mypa$$word!321"
VmUserName="sfadminuser"

# Login to Azure and set the subscription
az login

az account set --subscription <mySubscriptionID>

# Create resource group
az group create --name $ResourceGroupName --location $Location 

# Create secure five node Linux cluster. Creates a key vault in a resource group
# and creates a certficate in the key vault. The certificate's subject name must match 
# the domain that you use to access the Service Fabric cluster.  
# The certificate is downloaded locally as a PEM file.
az sf cluster create --resource-group $ResourceGroupName --location $Location \ 
--certificate-output-folder . --certificate-password $Password --certificate-subject-name $Subject \ 
--cluster-name $ClusterName --cluster-size 5 --os UbuntuServer1804 --vault-name $VaultName \ 
--vault-resource-group $ResourceGroupName --vm-password $VmPassword --vm-user-name $VmUserName

Megjegyzés

A webes előtérrendszer a konfigurációja szerint a 80-as porton figyeli a bejövő forgalmat. Alapértelmezés szerint a 80-as port meg van nyitva a fürt virtuális gépén és az Azure Load Balanceren.

A saját fürt létrehozásával kapcsolatos további információkért lásd: Service Fabric-fürt létrehozása az Azure-ban.

Az alkalmazás felépítése és üzembe helyezése a fürtön

A Service Fabric parancssori felületével helyezheti üzembe az alkalmazást az Azure-fürtben. Ha a Service Fabric parancssori felülete nincs telepítve a gépre, kövesse az itt található utasításokat a telepítéséhez.

Csatlakozzon az Azure Service Fabric-fürthöz. Cserélje le a példában szereplő végpontot a sajátjára. A végpontnak az alábbihoz hasonló teljes URL-címnek kell lennie. A PEM-fájl a korábban létrehozott önaláírt tanúsítvány.

sfctl cluster select --endpoint https://containertestcluster.eastus.cloudapp.azure.com:19080 --pem containertestcluster22019013100.pem --no-verify

Használja a TestContainer könyvtárban megadott telepítési szkriptet, hogy az alkalmazáscsomagot a fürt lemezképtárolójába másolja, regisztrálja az alkalmazás típusát, és hozza létre az alkalmazás egy példányát.

./install.sh

Nyisson meg egy böngészőt, és navigáljon a Service Fabric Explorer:https://containertestcluster.eastus.cloudapp.azure.com:19080/Explorer. Bontsa ki az alkalmazások csomópontját, és figyelje meg, hogy megjelenik benne egy bejegyzés az alkalmazás típusához, egy másik pedig a példányhoz.

Service Fabric Explorer

A futó alkalmazáshoz való csatlakozáshoz nyisson meg egy webböngészőt, és lépjen a fürt URL-címére – például http://containertestcluster.eastus.cloudapp.azure.com:80. A webes felhasználói felületen a szavazóalkalmazásnak kell megjelennie.

Képernyőkép az Azure szavazóalkalmazásról macskák, kutyák és alaphelyzetbe állítás gombokkal és összegekkel.

A fölöslegessé vált elemek eltávolítása

Használja a sablonban megadott eltávolítási szkriptet az alkalmazáspéldánynak a fürtről történő törléséhez, és törölje az alkalmazástípus regisztrációját. A parancsnak némi időre van szüksége, hogy kiürítse a példányt, ezért az „install.sh” parancs nem futtatható azonnal a szkript után.

./uninstall.sh

Példák teljes jegyzékfájlokra

ApplicationManifest.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ApplicationManifest ApplicationTypeName="TestContainerType" ApplicationTypeVersion="1.0.0" xmlns="http://schemas.microsoft.com/2011/01/fabric" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <ServiceManifestImport>
    <ServiceManifestRef ServiceManifestName="azurevotefrontPkg" ServiceManifestVersion="1.0.0"/>
    <Policies>
    <ContainerHostPolicies CodePackageRef="Code">
        <RepositoryCredentials AccountName="myaccountname" Password="<password>" PasswordEncrypted="false"/>
        <PortBinding ContainerPort="80" EndpointRef="azurevotefrontTypeEndpoint"/>
    </ContainerHostPolicies>
        </Policies>
  </ServiceManifestImport>
  <ServiceManifestImport>
    <ServiceManifestRef ServiceManifestName="azurevotebackPkg" ServiceManifestVersion="1.0.0"/>
      <Policies>
        <ContainerHostPolicies CodePackageRef="Code">
          <PortBinding ContainerPort="6379" EndpointRef="azurevotebackTypeEndpoint"/>
        </ContainerHostPolicies>
      </Policies>
  </ServiceManifestImport>
  <DefaultServices>
    <Service Name="azurevotefront">
      <StatelessService ServiceTypeName="azurevotefrontType" InstanceCount="1">
        <SingletonPartition/>
      </StatelessService>
    </Service>
    <Service Name="azurevoteback" ServiceDnsName="redisbackend.testapp">
      <StatelessService ServiceTypeName="azurevotebackType" InstanceCount="1">
        <SingletonPartition/>
      </StatelessService>
    </Service>
  </DefaultServices>
</ApplicationManifest>

Front-end ServiceManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<ServiceManifest Name="azurevotefrontPkg" Version="1.0.0"
                 xmlns="http://schemas.microsoft.com/2011/01/fabric" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" >

   <ServiceTypes>
      <StatelessServiceType ServiceTypeName="azurevotefrontType" UseImplicitHost="true">
   </StatelessServiceType>
   </ServiceTypes>

   <CodePackage Name="code" Version="1.0.0">
      <EntryPoint>
         <ContainerHost>
            <ImageName>acrName.azurecr.io/azure-vote-front:v1</ImageName>
            <Commands></Commands>
         </ContainerHost>
      </EntryPoint>
      <EnvironmentVariables>
      </EnvironmentVariables>
   </CodePackage>

  <Resources>
    <Endpoints>
      <!-- This endpoint is used by the communication listener to obtain the port on which to 
           listen. Please note that if your service is partitioned, this port is shared with 
           replicas of different partitions that are placed in your code. -->
      <Endpoint Name="azurevotefrontTypeEndpoint" UriScheme="http" Port="80" Protocol="http"/>
    </Endpoints>
  </Resources>

 </ServiceManifest>

Redis ServiceManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<ServiceManifest Name="azurevotebackPkg" Version="1.0.0"
                 xmlns="http://schemas.microsoft.com/2011/01/fabric" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" >

   <ServiceTypes>
      <StatelessServiceType ServiceTypeName="azurevotebackType" UseImplicitHost="true">
   </StatelessServiceType>
   </ServiceTypes>

   <CodePackage Name="code" Version="1.0.0">
      <EntryPoint>
         <ContainerHost>
            <Commands></Commands>
         </ContainerHost>
      </EntryPoint>
      <EnvironmentVariables>
      </EnvironmentVariables>
   </CodePackage>
     <Resources>
    <Endpoints>
      <!-- This endpoint is used by the communication listener to obtain the port on which to 
           listen. Please note that if your service is partitioned, this port is shared with 
           replicas of different partitions that are placed in your code. -->
      <Endpoint Name="azurevotebackTypeEndpoint" Port="6379" Protocol="tcp"/>
    </Endpoints>
  </Resources>
 </ServiceManifest>

Következő lépések

Ebben az oktatóanyagban több tárolót csomagolt egy Service Fabric-alkalmazásba a Yeoman használatával, majd az alkalmazást üzembe helyezte és futtatta egy Service Fabric-fürtön. A következő lépéseket hajtotta végre:

  • A Yeoman telepítése
  • Alkalmazáscsomag létrehozása a Yeoman használatával
  • Az alkalmazáscsomag beállításainak konfigurálása a tárolókkal való használathoz
  • Az alkalmazás létrehozása
  • Az alkalmazás üzembe helyezése és futtatása
  • Az alkalmazás fölösleges elemeinek az eltávolítása

Folytassa a következő oktatóanyaggal, amely az alkalmazás feladatátvételét és méretezését ismerteti a Service Fabricben.

Tudnivalók az alkalmazások feladatátvételéről és méretezéséről