Azure Stack Edge Pro GPU-eszköz kezelése a Windows PowerShell használatával

ÉRVÉNYES:Yes for Pro GPU SKUAzure Stack Edge Pro – GPUYes for Pro 2 SKUAzure Stack Edge Pro 2Yes for Pro R SKUAzure Stack Edge Pro RYes for Mini R SKUAzure Stack Edge Mini R

Az Azure Stack Edge Pro GPU-megoldással feldolgozhatja az adatokat, és elküldheti azokat a hálózaton keresztül az Azure-ba. Ez a cikk az Azure Stack Edge Pro GPU-eszköz konfigurációs és felügyeleti feladatait ismerteti. Az eszköz kezeléséhez használhatja az Azure Portalt, a helyi webes felhasználói felületet vagy a Windows PowerShell-felületet.

Ez a cikk azt ismerteti, hogyan csatlakozhat az eszköz PowerShell-felületéhez, és hogy milyen feladatokat végezhet ezen felület használatával.

Csatlakozás a PowerShell-felülethez

Az ügyfél operációs rendszerétől függően az eszközhöz való távoli csatlakozás eljárásai eltérőek.

Távoli csatlakozás Windows-ügyfélről

Előfeltételek

Mielőtt hozzákezd, győződjön meg az alábbiakról:

  • A Windows-ügyfél Windows PowerShell 5.0-s vagy újabb verzióját futtatja.

  • A Windows-ügyfél rendelkezik az eszközön telepített csomóponttanúsítványnak megfelelő aláírási lánccal (főtanúsítvány). Részletes útmutatásért tekintse meg a Tanúsítvány telepítése Windows-ügyfélen című témakört.

  • A hosts Windows-ügyfélnél C:\Windows\System32\drivers\etc található fájl a csomóponttanúsítványnak megfelelő bejegyzéssel rendelkezik a következő formátumban:

    <Device IP> <Node serial number>.<DNS domain of the device>

    Íme egy példabejegyzés a hosts fájlhoz:

    10.100.10.10 1HXQG13.wdshcsso.com

Részletes lépések

Az alábbi lépéseket követve távolról csatlakozhat Windows-ügyfélről.

  1. Windows PowerShell-munkamenet futtatása rendszergazdaként.

  2. Győződjön meg arról, hogy a Windows távfelügyeleti szolgáltatás fut az ügyfélen. A parancssorba írja be a következőt:

    winrm quickconfig
    

    További információ: Telepítés és konfiguráció a Windows távfelügyelethez.

  3. Rendeljen hozzá egy változót a fájlban hosts használt kapcsolati sztring.

    $Name = "<Node serial number>.<DNS domain of the device>"
    

    Cserélje le és <DNS domain of the device> írja be <Node serial number> az eszköz csomópont sorozatszámát és DNS-tartományát. A csomópont sorozatszámának értékeit a Tanúsítványok lapról és a DNS-tartományból szerezheti be az eszköz helyi webes felhasználói felületén található Eszköz lapról.

  4. Ha hozzá szeretné adni ezt a kapcsolati sztring az eszközhöz az ügyfél megbízható gazdagépeinek listájához, írja be a következő parancsot:

    Set-Item WSMan:\localhost\Client\TrustedHosts $Name -Concatenate -Force
    
  5. Windows PowerShell-munkamenet indítása az eszközön:

    Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSL
    

    Ha a megbízhatósági kapcsolattal kapcsolatos hibát lát, ellenőrizze, hogy az eszközre feltöltött csomóponttanúsítvány aláírási lánca is telepítve van-e az eszközhöz hozzáférő ügyfélen.

  6. Adja meg a jelszót, amikor a rendszer kéri. Használja ugyanazt a jelszót, amelyet a helyi webes felhasználói felületre való bejelentkezéshez használ. A helyi webes felhasználói felület alapértelmezett jelszava a Password1. Ha sikeresen csatlakozik az eszközhöz távoli PowerShell használatával, a következő mintakimenet jelenik meg:

    Windows PowerShell
    Copyright (C) Microsoft Corporation. All rights reserved.
    
    PS C:\WINDOWS\system32> winrm quickconfig
    WinRM service is already running on this machine.
    PS C:\WINDOWS\system32> $Name = "1HXQG13.wdshcsso.com"
    PS C:\WINDOWS\system32> Set-Item WSMan:\localhost\Client\TrustedHosts $Name -Concatenate -Force
    PS C:\WINDOWS\system32> Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSL
    
    WARNING: The Windows PowerShell interface of your device is intended to be used only for the initial network configuration. Please engage Microsoft Support if you need to access this interface to troubleshoot any potential issues you may be experiencing. Changes made through this interface without involving Microsoft Support could result in an unsupported configuration.
    [1HXQG13.wdshcsso.com]: PS>
    

Ha ezt a -UseSSL lehetőséget használja, a PowerShellen keresztül https-en keresztül újra kell ismételned. Javasoljuk, hogy a Https használatával mindig távolról csatlakozzon a PowerShell-lel. A megbízható hálózatokon belül a PowerShell-lel http-en keresztül történő újramotálás elfogadható. Először http-en keresztül engedélyezi a távoli PowerShellt a helyi felhasználói felületen. Ezután az előző eljárással csatlakozhat az eszköz PowerShell-felületéhez a -UseSSL beállítás nélkül.

Ha nem a tanúsítványokat használja (javasoljuk, hogy használja a tanúsítványokat!), a munkamenet beállításaival kihagyhatja a tanúsítványérvényesítési ellenőrzést: -SkipCACheck -SkipCNCheck -SkipRevocationCheck.

$sessOptions = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck 
Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSL -SessionOption $sessOptions    

Íme egy példakimenet a tanúsítványellenőrzés kihagyásakor:

PS C:\WINDOWS\system32> $Name = "1HXQG13.wdshcsso.com"
PS C:\WINDOWS\system32> $sessOptions = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck
PS C:\WINDOWS\system32> $sessOptions

MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : None
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : True
SkipCNCheck                       : True
SkipRevocationCheck               : True
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
IncludePortInSPN                  : False
OutputBufferingMode               : None
MaxConnectionRetryCount           : 0
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : -00:00:00.0010000

PS C:\WINDOWS\system32> Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSL -SessionOption $sessOptions
WARNING: The Windows PowerShell interface of your device is intended to be used only for the initial network configuration. Please
engage Microsoft Support if you need to access this interface to troubleshoot any potential issues you may be experiencing.
Changes made through this interface without involving Microsoft Support could result in an unsupported configuration.
[1HXQG13.wdshcsso.com]: PS>

Fontos

Az aktuális kiadásban csak Windows-ügyfélen keresztül csatlakozhat az eszköz PowerShell-felületéhez. A -UseSSL beállítás nem működik a Linux-ügyfelekkel.

Támogatási csomag létrehozása

Ha bármilyen eszközproblémát tapasztal, létrehozhat egy támogatási csomagot a rendszernaplókból. Microsoft ügyfélszolgálata ezzel a csomagkal hárítja el a problémákat. Támogatási csomag létrehozásához kövesse az alábbi lépéseket:

  1. Csatlakozás az eszköz PowerShell-felületére.

  2. Get-HcsNodeSupportPackage A parancs használatával hozzon létre egy támogatási csomagot. A parancsmag használata a következő:

    Get-HcsNodeSupportPackage [-Path] <string> [-Zip] [-ZipFileName <string>] [-Include {None | RegistryKeys | EtwLogs
            | PeriodicEtwLogs | LogFiles | DumpLog | Platform | FullDumps | MiniDumps | ClusterManagementLog | ClusterLog |
            UpdateLogs | CbsLogs | StorageCmdlets | ClusterCmdlets | ConfigurationCmdlets | KernelDump | RollbackLogs |
            Symbols | NetworkCmdlets | NetworkCmds | Fltmc | ClusterStorageLogs | UTElement | UTFlag | SmbWmiProvider |
            TimeCmds | LocalUILogs | ClusterHealthLogs | BcdeditCommand | BitLockerCommand | DirStats | ComputeRolesLogs |
            ComputeCmdlets | DeviceGuard | Manifests | MeasuredBootLogs | Stats | PeriodicStatLogs | MigrationLogs |
            RollbackSupportPackage | ArchivedLogs | Default}] [-MinimumTimestamp <datetime>] [-MaximumTimestamp <datetime>]
            [-IncludeArchived] [-IncludePeriodicStats] [-Credential <pscredential>]  [<CommonParameters>]
    

    A parancsmag összegyűjti a naplókat az eszközről, és ezeket a naplókat egy megadott hálózatra vagy helyi megosztásra másolja.

    A használt paraméterek a következők:

    • -Path – Adja meg a támogatási csomag másolásához a hálózatot vagy a helyi elérési utat. (szükséges)
    • -Credential – Adja meg a védett elérési út eléréséhez szükséges hitelesítő adatokat.
    • -Zip – Zip-fájl létrehozásához adja meg.
    • -Include – Adja meg, hogy a támogatási csomagban szerepeljenek az összetevők. Ha nincs megadva, Default feltételezzük.
    • -IncludeArchived – Adja meg, hogy az archivált naplók szerepeljenek a támogatási csomagban.
    • -IncludePeriodicStats – Adja meg, hogy a támogatási csomagban szerepeljenek rendszeres statisztikás naplók.

Eszközadatok megtekintése

  1. Csatlakozás a PowerShell-felülethez.

  2. Get-HcsApplianceInfo A segítségével lekérheti az eszköz adatait.

    Az alábbi példa a parancsmag használatát mutatja be:

    [10.100.10.10]: PS>Get-HcsApplianceInfo
    
    Id                            : b2044bdb-56fd-4561-a90b-407b2a67bdfc
    FriendlyName                  : DBE-NBSVFQR94S6
    Name                          : DBE-NBSVFQR94S6
    SerialNumber                  : HCS-NBSVFQR94S6
    DeviceId                      : 40d7288d-cd28-481d-a1ea-87ba9e71ca6b
    Model                         : Virtual
    FriendlySoftwareVersion       : Data Box Gateway 1902
    HcsVersion                    : 1.4.771.324
    IsClustered                   : False
    IsVirtual                     : True
    LocalCapacityInMb             : 1964992
    SystemState                   : Initialized
    SystemStatus                  : Normal
    Type                          : DataBoxGateway
    CloudReadRateBytesPerSec      : 0
    CloudWriteRateBytesPerSec     : 0
    IsInitialPasswordSet          : True
    FriendlySoftwareVersionNumber : 1902
    UploadPolicy                  : All
    DataDiskResiliencySettingName : Simple
    ApplianceTypeFriendlyName     : Data Box Gateway
    IsRegistered                  : False
    

    Az alábbi táblázat összefoglalja az eszköz néhány fontos információját:

    Paraméter Leírás
    FriendlyName Az eszköz rövid neve a helyi webes felhasználói felületen konfigurálva az eszköz üzembe helyezése során. Az alapértelmezett rövid név az eszköz sorozatszáma.
    Sorozatszám Az eszköz sorozatszáma a gyárban hozzárendelt egyedi szám.
    Modell Az Azure Stack Edge- vagy Data Box Gateway-eszköz modellje. A modell fizikai az Azure Stack Edge-hez és virtuális a Data Box Gatewayhez.
    FriendlySoftwareVersion Az eszköz szoftververziójának megfelelő felhasználóbarát sztring. Az előzetes verziót futtató rendszerek esetében a szoftverbarát verzió a Data Box Edge 1902 lenne.
    HcsVersion Az eszközön futó HCS-szoftververzió. A Data Box Edge 1902-nek megfelelő HCS-szoftververzió például 1.4.771.324.
    LocalCapacityInMb Az eszköz teljes helyi kapacitása a Megabitsben.
    Regisztrálva van Ez az érték azt jelzi, hogy az eszköz aktiválva van-e a szolgáltatással.

GPU-illesztőprogram adatainak megtekintése

Ha a számítási szerepkör konfigurálva van az eszközön, a GPU-illesztő adatait a PowerShell-felületen is lekérheti.

  1. Csatlakozás a PowerShell-felülethez.

  2. Get-HcsGpuNvidiaSmi A használatával lekérheti az eszköz GPU-illesztőprogramjának adatait.

    Az alábbi példa a parancsmag használatát mutatja be:

    Get-HcsGpuNvidiaSmi
    

    Jegyezze fel a parancsmag mintakimenetének illesztőprogram-adatait.

    +-----------------------------------------------------------------------------+    
    | NVIDIA-SMI 440.64.00    Driver Version: 440.64.00    CUDA Version: 10.2     |    
    |-------------------------------+----------------------+----------------------+    
    | GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |    
    | Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |    
    |===============================+======================+======================|    
    |   0  Tesla T4            On   | 000029CE:00:00.0 Off |                    0 |    
    | N/A   60C    P0    29W /  70W |   1539MiB / 15109MiB |      0%      Default |    
    +-------------------------------+----------------------+----------------------+    
    |   1  Tesla T4           On  | 0000AD50:00:00.0 Off |                    0 |
    | N/A   58C    P0    29W /  70W |    330MiB / 15109MiB |      0%      Default |
    +-------------------------------+----------------------+----------------------+
    

Többfolyamatos szolgáltatás (MPS) engedélyezése

Az Nvidia GPU-kon futó többfolyamatos szolgáltatás (MPS) olyan mechanizmust biztosít, amelyben a GPU-kat több feladat is megoszthatja, ahol minden feladat a GPU erőforrásainak bizonyos százalékát foglalja le. Az MPS egy előzetes verziójú funkció az Azure Stack Edge Pro GPU-eszközön. Ha engedélyezni szeretné az MPS-t az eszközön, kövesse az alábbi lépéseket:

  1. Mielőtt hozzákezd, győződjön meg az alábbiakról:

    1. Konfigurálta és aktiválta az Azure Stack Edge Pro-eszközt egy Azure Stack Edge-erőforrással az Azure-ban.
    2. Ezen az eszközön konfigurálta a számítást az Azure Portalon.
  2. Csatlakozás a PowerShell-felülethez.

  3. Az MPS engedélyezéséhez használja az alábbi parancsot az eszközön.

    Start-HcsGpuMPS
    

Feljegyzés

Az eszközszoftver és a Kubernetes-fürt frissítésekor az MPS-beállítás nem marad meg a számítási feladatokhoz. Újra engedélyeznie kell az MPS-t.

Az eszköz alaphelyzetbe állítása

Az eszköz visszaállításához biztonságosan törölnie kell az eszköz adatlemezén és rendszerindító lemezén található összes adatot.

Használja a Reset-HcsAppliance parancsmagot az adatlemezek és a rendszerindító lemez, vagy csak az adatlemezek adatainak törléséhez. Az SecureWipeBootDisk és SecureWipeDataDisks a kapcsolók lehetővé teszik a rendszerindító lemez és az adatlemezek törlését.

A SecureWipeBootDisk kapcsoló törli a rendszerindító lemezt, és használhatatlanná teszi az eszközt. Csak akkor érdemes használni, ha az eszközt vissza kell küldeni a Microsoftnak. További információért lásd az eszköz Microsoftnak való visszaküldését ismertető szakaszt.

Ha az eszköz visszaállításához a helyi webes felhasználói felületet használja, csak az adatlemezek biztonságos törlése megy végbe, a rendszerindító lemez pedig érintetlen marad. A rendszerindító lemez tartalmazza az eszköz konfigurációját.

  1. Csatlakozás a PowerShell-felülethez.

  2. A parancssorba írja be a következőt:

    Reset-HcsAppliance -SecureWipeBootDisk -SecureWipeDataDisks

    Az alábbi példa bemutatja, hogyan használhatja ezt a parancsmagot:

    [10.128.24.33]: PS>Reset-HcsAppliance -SecureWipeBootDisk -SecureWipeDataDisks
    
    Confirm
    Are you sure you want to perform this action?
    Performing the operation "Reset-HcsAppliance" on target "ShouldProcess appliance".
    [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [?] Help (default is "Y"): N
    

Számítási naplók lekérése

Ha a számítási szerepkör konfigurálva van az eszközön, a számítási naplókat a PowerShell-felületen keresztül is lekérheti.

  1. Csatlakozás a PowerShell-felülethez.

  2. Get-AzureDataBoxEdgeComputeRoleLogs A segítségével lekérheti az eszköz számítási naplóit.

    Az alábbi példa a parancsmag használatát mutatja be:

    Get-AzureDataBoxEdgeComputeRoleLogs -Path "\\hcsfs\logs\myacct" -Credential "username" -FullLogCollection    
    

    Íme a parancsmaghoz használt paraméterek leírása:

    • Path: Adjon meg egy hálózati útvonalat ahhoz a megosztáshoz, ahol létre szeretné hozni a számítási naplócsomagot.
    • Credential: Adja meg a hálózati megosztás felhasználónevét. A parancsmag futtatásakor meg kell adnia a megosztási jelszót.
    • FullLogCollection: Ez a paraméter biztosítja, hogy a naplócsomag tartalmazza az összes számítási naplót. Alapértelmezés szerint a naplócsomag csak a naplók egy részhalmazát tartalmazza.

Kubernetes-számítási feladatok profiljainak módosítása

Miután létrehozott és konfigurált egy fürtöt, és új virtuális kapcsolókat hozott létre, hozzáadhat vagy törölhet virtuális kapcsolókkal társított virtuális hálózatokat. A részletes lépésekért lásd a virtuális kapcsolók konfigurálását ismertető témakört.

A virtuális kapcsolók létrehozása után engedélyezheti a Kubernetes számítási forgalmának kapcsolóit a Kubernetes számításiprofiljának megadásához. Ehhez használja a helyi felhasználói felületet a számítási IPS konfigurálásához szükséges lépésekkel. Ehhez a PowerShell használatával hajtsa végre az alábbi lépéseket:

  1. Csatlakozás a PowerShell-felülethez.

  2. Get-HcsApplianceInfo A parancsmaggal lekérheti az eszköz aktuális KubernetesPlatform és KubernetesWorkloadProfile beállításait.

  3. Get-HcsKubernetesWorkloadProfiles A parancsmaggal azonosíthatja az Azure Stack Edge-eszközön elérhető profilokat.

    [Device-IP]: PS>Get-HcsKubernetesWorkloadProfiles 
    Type  Description    
    ----  -----------   
    AP5GC an Azure Private MEC solution   
    SAP   a SAP Digital Manufacturing for Edge Computing or another Microsoft partner solution   
    NONE  other workloads
    [Device-IP]: PS>
    
  4. Set-HcsKubernetesWorkloadProfile A parancsmaggal beállíthatja az AP5GC, egy Azure Private MEC-megoldás számítási feladatprofiljának beállítását.

    Az alábbi példa a parancsmag használatát mutatja be:

    Set-HcsKubernetesWorkloadProfile -Type "AP5GC"
    

    A parancsmag mintakimenete a következő:

    [10.100.10.10]: PS>KubernetesPlatform : AKS
    [10.100.10.10]: PS>KubernetesWorkloadProfile : AP5GC
    [10.100.10.10]: PS>
    

Kubernetes-pod és szolgáltatási alhálózatok módosítása

Ha a környezetben a többi számítási feladatot is futtatja, alapértelmezés szerint az Azure Stack Edge-eszközön lévő Kubernetes a pod és a szolgáltatás esetében a 172.27.0.0/16 és a 172.28.0.0/16 alhálózatot használja. Ha ezek az alhálózatok már használatban vannak a hálózaton, a parancsmag futtatásával Set-HcsKubeClusterNetworkInfo módosíthatja ezeket az alhálózatokat.

Ezt a konfigurációt az Azure Portalról történő számítás konfigurálása előtt szeretné elvégezni, mivel ebben a lépésben létrejön a Kubernetes-fürt.

  1. Csatlakozás az eszköz PowerShell-felületére.

  2. Az eszköz PowerShell-felületén futtassa a következőt:

    Set-HcsKubeClusterNetworkInfo -PodSubnet <subnet details> -ServiceSubnet <subnet details>

    Cserélje le az <alhálózat adatait> a használni kívánt alhálózati tartományra.

  3. A parancs futtatása után a Get-HcsKubeClusterNetworkInfo paranccsal ellenőrizheti, hogy a pod- és szolgáltatásalhálózatok megváltoztak-e.

Íme egy mintakimenet ehhez a parancshoz.

[10.100.10.10]: PS>Set-HcsKubeClusterNetworkInfo -PodSubnet 10.96.0.1/16 -ServiceSubnet 10.97.0.1/16
[10.100.10.10]: PS>Get-HcsKubeClusterNetworkInfo

Id                                   PodSubnet    ServiceSubnet
--                                   ---------    -------------
6dbf23c3-f146-4d57-bdfc-76cad714cfd1 10.96.0.1/16 10.97.0.1/16
[10.100.10.10]: PS>

Mielőtt hozzákezdene, a következőt kell tennie:

A számítási szerepkörrel konfigurált Azure Stack Edge Pro GPU-eszközön két különböző parancskészlettel háríthatja el vagy figyelheti az eszközt.

  • Parancsok használata iotedge . Ezek a parancsok az eszköz alapműveleteihez érhetők el.
  • Parancsok használata kubectl . Ezek a parancsok számos művelethez érhetők el az eszközhöz.

A fenti parancsok bármelyikének végrehajtásához Csatlakozás kell a PowerShell-felületre.

Parancsok használata iotedge

Az elérhető parancsok listájának megtekintéséhez csatlakozzon a PowerShell-felülethez, és használja a függvénytiotedge.

[10.100.10.10]: PS>iotedge -?                                                                                                                           
Usage: iotedge COMMAND

Commands:
   list
   logs
   restart

[10.100.10.10]: PS>

Az alábbi táblázat a következő iotedgeparancsok rövid leírását tartalmazza:

command Leírás
list Modulok listázása
logs Modul naplóinak lekérése
restart Modul leállítása és újraindítása

Az összes IoT Edge-modul listázása

Az eszközön futó összes modul listázásához használja a iotedge list parancsot.

Íme a parancs mintakimenete. Ez a parancs felsorolja az összes modult, a társított konfigurációt és a modulokkal társított külső IP-címeket. A webkiszolgáló alkalmazás például a következő címen https://10.128.44.244érhető el: .

[10.100.10.10]: PS>iotedge list

NAME                   STATUS  DESCRIPTION CONFIG                                             EXTERNAL-IP
----                   ------  ----------- ------                                             -----
gettingstartedwithgpus Running Up 10 days  mcr.microsoft.com/intelligentedge/solutions:latest
iotedged               Running Up 10 days  azureiotedge/azureiotedge-iotedged:0.1.0-beta10    <none>
edgehub                Running Up 10 days  mcr.microsoft.com/azureiotedge-hub:1.0             10.128.44.243
edgeagent              Running Up 10 days  azureiotedge/azureiotedge-agent:0.1.0-beta10
webserverapp           Running Up 10 days  nginx:stable                                       10.128.44.244

[10.100.10.10]: PS>

Modulok újraindítása

A list paranccsal listázhatja az eszközön futó összes modult. Ezután azonosítsa az újraindítani kívánt modul nevét, és használja azt a restart paranccsal.

Az alábbi mintakimenet bemutatja, hogyan indíthat újra egy modult. A modul futási ideje alapján láthatja, hogy cuda-sample1 a modul újraindult.

[10.100.10.10]: PS>iotedge list

NAME         STATUS  DESCRIPTION CONFIG                                          EXTERNAL-IP PORT(S)
----         ------  ----------- ------                                          ----------- -------
edgehub      Running Up 5 days   mcr.microsoft.com/azureiotedge-hub:1.0          10.57.48.62 443:31457/TCP,5671:308
                                                                                             81/TCP,8883:31753/TCP
iotedged     Running Up 7 days   azureiotedge/azureiotedge-iotedged:0.1.0-beta13 <none>      35000/TCP,35001/TCP
cuda-sample2 Running Up 1 days   nvidia/samples:nbody
edgeagent    Running Up 7 days   azureiotedge/azureiotedge-agent:0.1.0-beta13
cuda-sample1 Running Up 1 days   nvidia/samples:nbody

[10.100.10.10]: PS>iotedge restart cuda-sample1
[10.100.10.10]: PS>iotedge list

NAME         STATUS  DESCRIPTION  CONFIG                                          EXTERNAL-IP PORT(S)
----         ------  -----------  ------                                          ----------- -------
edgehub      Running Up 5 days    mcr.microsoft.com/azureiotedge-hub:1.0          10.57.48.62 443:31457/TCP,5671:30
                                                                                              881/TCP,8883:31753/TC
                                                                                              P
iotedged     Running Up 7 days    azureiotedge/azureiotedge-iotedged:0.1.0-beta13 <none>      35000/TCP,35001/TCP
cuda-sample2 Running Up 1 days    nvidia/samples:nbody
edgeagent    Running Up 7 days    azureiotedge/azureiotedge-agent:0.1.0-beta13
cuda-sample1 Running Up 4 minutes nvidia/samples:nbody

[10.100.10.10]: PS>

Modulnaplók lekérése

logs A paranccsal naplókat kérhet le az eszközön futó IoT Edge-modulhoz.

Ha hiba történt a tárolórendszerkép létrehozásakor vagy a rendszerkép lekérése közben, futtassa a parancsot logs edgeagent. edgeagent az IoT Edge futtatókörnyezeti tárolója, amely más tárolók kiépítéséért felelős. Mivel logs edgeagent az összes naplót leképezi, a legutóbbi hibák megtekintéséhez érdemes a 0 lehetőséget --tail használni.

Íme egy mintakimenet.

[10.100.10.10]: PS>iotedge logs cuda-sample2 --tail 10
[10.100.10.10]: PS>iotedge logs edgeagent --tail 10
<6> 2021-02-25 00:52:54.828 +00:00 [INF] - Executing command: "Report EdgeDeployment status: [Success]"
<6> 2021-02-25 00:52:54.829 +00:00 [INF] - Plan execution ended for deployment 11
<6> 2021-02-25 00:53:00.191 +00:00 [INF] - Plan execution started for deployment 11
<6> 2021-02-25 00:53:00.191 +00:00 [INF] - Executing command: "Create an EdgeDeployment with modules: [cuda-sample2, edgeAgent, edgeHub, cuda-sample1]"
<6> 2021-02-25 00:53:00.212 +00:00 [INF] - Executing command: "Report EdgeDeployment status: [Success]"
<6> 2021-02-25 00:53:00.212 +00:00 [INF] - Plan execution ended for deployment 11
<6> 2021-02-25 00:53:05.319 +00:00 [INF] - Plan execution started for deployment 11
<6> 2021-02-25 00:53:05.319 +00:00 [INF] - Executing command: "Create an EdgeDeployment with modules: [cuda-sample2, edgeAgent, edgeHub, cuda-sample1]"
<6> 2021-02-25 00:53:05.412 +00:00 [INF] - Executing command: "Report EdgeDeployment status: [Success]"
<6> 2021-02-25 00:53:05.412 +00:00 [INF] - Plan execution ended for deployment 11
[10.100.10.10]: PS>

Feljegyzés

Az Olyan közvetlen metódusok, mint a GetModuleLogs vagy az UploadModuleLogs nem támogatottak az Azure Stack Edge-en futó Kubernetes IoT Edge-en.

Kubectl-parancsok használata

A számítási szerepkört konfigurált Azure Stack Edge Pro GPU-eszközön az összes parancs elérhető a kubectl modulok figyeléséhez vagy hibaelhárításához. Az elérhető parancsok listájának megtekintéséhez futtassa kubectl --help a parancsablakból.

C:\Users\myuser>kubectl --help

kubectl controls the Kubernetes cluster manager.

Find more information at: https://kubernetes.io/docs/reference/kubectl/overview/

Basic Commands (Beginner):
    create         Create a resource from a file or from stdin.
    expose         Take a replication controller, service, deployment or pod and expose it as a new Kubernetes Service
    run            Run a particular image on the cluster
    set            Set specific features on objects
    run-container  Run a particular image on the cluster. This command is deprecated, use "run" instead
==============CUT=============CUT============CUT========================

Usage:
    kubectl [flags] [options]

Use "kubectl <command> --help" for more information about a given command.
Use "kubectl options" for a list of global command-line options (applies to all commands).

C:\Users\myuser>

A parancsok átfogó listájáért látogasson el a kubectlkubectl cheatsheet webhelyre.

Szolgáltatás vagy modul IP-címének a Kubernetes-fürtön kívül történő megjelenítése

Egy terheléselosztási szolgáltatás vagy a Kubernetesen kívül közzétett modulok IP-címének lekéréséhez futtassa a következő parancsot:

kubectl get svc -n iotedge

Az alábbiakban a Kubernetes-fürtön kívül közzétett összes szolgáltatás vagy modul mintakimenete látható.

[10.100.10.10]: PS>kubectl get svc -n iotedge
NAME           TYPE           CLUSTER-IP      EXTERNAL-IP     PORT(S)                                       AGE
edgehub        LoadBalancer   10.103.52.225   10.128.44.243   443:31987/TCP,5671:32336/TCP,8883:30618/TCP   34h
iotedged       ClusterIP      10.107.236.20   <none>          35000/TCP,35001/TCP                           3d8h
webserverapp   LoadBalancer   10.105.186.35   10.128.44.244   8080:30976/TCP                                16h

[10.100.10.10]: PS>

A Külső IP-oszlop IP-címe a szolgáltatás vagy a modul külső végpontjának felel meg. A külső IP-címet a Kubernetes-irányítópulton is lekérheti.

Annak ellenőrzése, hogy a modul sikeresen üzembe lett-e helyezve

A számítási modulok olyan tárolók, amelyek üzleti logikával rendelkeznek. Egy Kubernetes-pod több tárolóval is rendelkezhet.

Annak ellenőrzéséhez, hogy egy számítási modul telepítése sikeresen megtörtént-e, csatlakozzon az eszköz PowerShell-felületéhez. Futtassa a get pods parancsot, és ellenőrizze, hogy a tároló (a számítási modulnak megfelelő) fut-e.

Egy adott névtérben futó podok listájának lekéréséhez futtassa a következő parancsot:

get pods -n <namespace>

Az IoT Edge-en keresztül üzembe helyezett modulok ellenőrzéséhez futtassa a következő parancsot:

get pods -n iotedge

Az alábbiakban a névtérben futó összes pod mintakimenete iotedge található.

[10.100.10.10]: PS>kubectl get pods -n iotedge
NAME                        READY   STATUS    RESTARTS   AGE
edgeagent-cf6d4ffd4-q5l2k   2/2     Running   0          20h
edgehub-8c9dc8788-2mvwv     2/2     Running   0          56m
filemove-66c49984b7-h8lxc   2/2     Running   0          56m
iotedged-675d7f4b5f-9nml4   1/1     Running   0          20h

[10.100.10.10]: PS>

Az állapot azt jelzi, hogy a névtér összes podja fut, a Kész pedig a podban üzembe helyezett tárolók számát jelzi. Az előző mintában az összes pod fut, és az egyes podokban üzembe helyezett összes modul fut.

Az Azure Arcon keresztül üzembe helyezett modulok ellenőrzéséhez futtassa a következő parancsot:

get pods -n azure-arc

Másik lehetőségként Csatlakozás a Kubernetes-irányítópultra az IoT Edge vagy az Azure Arc üzembe helyezésének megtekintéséhez.

Egy adott névtér adott podjának részletesebb kimenetéhez futtassa a következő parancsot:

kubectl describe pod <pod name> -n <namespace>

A mintakimenet itt látható.

[10.100.10.10]: PS>kubectl describe pod filemove-66c49984b7 -n iotedge
Name:           filemove-66c49984b7-h8lxc
Namespace:      iotedge
Priority:       0
Node:           k8s-1hwf613cl-1hwf613/10.139.218.12
Start Time:     Thu, 14 May 2020 12:46:28 -0700
Labels:         net.azure-devices.edge.deviceid=myasegpu-edge
                net.azure-devices.edge.hub=myasegpu2iothub.azure-devices.net
                net.azure-devices.edge.module=filemove
                pod-template-hash=66c49984b7
Annotations:    net.azure-devices.edge.original-moduleid: filemove
Status:         Running
IP:             172.17.75.81
IPs:            <none>
Controlled By:  ReplicaSet/filemove-66c49984b7
Containers:
    proxy:
    Container ID:   docker://fd7975ca78209a633a1f314631042a0892a833b7e942db2e7708b41f03e8daaf
    Image:          azureiotedge/azureiotedge-proxy:0.1.0-beta8
    Image ID:       docker://sha256:5efbf6238f13d24bab9a2b499e5e05bc0c33ab1587d6cf6f289cdbe7aa667563
    Port:           <none>
    Host Port:      <none>
    State:          Running
        Started:      Thu, 14 May 2020 12:46:30 -0700
    Ready:          True
    Restart Count:  0
    Environment:
        PROXY_LOG:  Debug
=============CUT===============================CUT===========================
Volumes:
    config-volume:
    Type:      ConfigMap (a volume populated by a ConfigMap)
    Name:      iotedged-proxy-config
    Optional:  false
    trust-bundle-volume:
    Type:      ConfigMap (a volume populated by a ConfigMap)
    Name:      iotedged-proxy-trust-bundle
    Optional:  false
    myasesmb1local:
    Type:       PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
    ClaimName:  myasesmb1local
    ReadOnly:   false
    myasesmb1:
    Type:       PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
    ClaimName:  myasesmb1
    ReadOnly:   false
    filemove-token-pzvw8:
    Type:        Secret (a volume populated by a Secret)
    SecretName:  filemove-token-pzvw8
    Optional:    false
QoS Class:       BestEffort
Node-Selectors:  <none>
Tolerations:     node.kubernetes.io/not-ready:NoExecute for 300s
                    node.kubernetes.io/unreachable:NoExecute for 300s
Events:          <none>


[10.100.10.10]: PS>

Tárolónaplók lekérése

Egy modul naplóinak lekéréséhez futtassa az alábbi parancsot az eszköz PowerShell-felületéről:

kubectl logs <pod_name> -n <namespace> --all-containers

Mivel all-containers a jelző az összes tároló összes naplóját leképezi, a legutóbbi hibák megtekintésének jó módja a beállítás --tail 10használata.

Az alábbiakban egy mintakimenetet követünk.

[10.100.10.10]: PS>kubectl logs filemove-66c49984b7-h8lxc -n iotedge --all-containers --tail 10
DEBUG 2020-05-14T20:40:42Z: loop process - 0 events, 0.000s
DEBUG 2020-05-14T20:40:44Z: loop process - 0 events, 0.000s
DEBUG 2020-05-14T20:40:44Z: loop process - 0 events, 0.000s
DEBUG 2020-05-14T20:40:44Z: loop process - 1 events, 0.000s
DEBUG 2020-05-14T20:40:44Z: loop process - 0 events, 0.000s
DEBUG 2020-05-14T20:42:12Z: loop process - 0 events, 0.000s
DEBUG 2020-05-14T20:42:14Z: loop process - 0 events, 0.000s
DEBUG 2020-05-14T20:42:14Z: loop process - 0 events, 0.000s
DEBUG 2020-05-14T20:42:14Z: loop process - 1 events, 0.000s
DEBUG 2020-05-14T20:42:14Z: loop process - 0 events, 0.000s
05/14/2020 19:46:44: Info: Opening module client connection.
05/14/2020 19:46:45: Info: Open done.
05/14/2020 19:46:45: Info: Initializing with input: /home/input, output: /home/output, protocol: Amqp.
05/14/2020 19:46:45: Info: IoT Hub module client initialized.

[10.100.10.10]: PS>

Kubernetes munkavégző csomópont memória- és processzorkorlátainak módosítása

A Kubernetes-feldolgozó csomópont memória- vagy processzorkorlátjának módosításához hajtsa végre a következő lépéseket:

  1. Csatlakozás az eszköz PowerShell-felületére.

  2. A feldolgozó csomópont aktuális erőforrásainak és a szerepkör-beállításoknak a lekéréséhez futtassa a következő parancsot:

    Get-AzureDataBoxEdgeRole

    Íme egy mintakimenet. Jegyezze fel a szakasz értékeitName.ComputeResources MemoryInBytes és ProcessorCount a Kubernetes-feldolgozó csomóponthoz jelenleg hozzárendelt értékek memória- és processzorszámát jelöli.

    [10.100.10.10]: PS>Get-AzureDataBoxEdgeRole
    ImageDetail                : Name:mcr.microsoft.com/azureiotedge-agent
                                 Tag:1.0
                                 PlatformType:Linux
    EdgeDeviceConnectionString :
    IotDeviceConnectionString  :
    HubHostName                : ase-srp-007.azure-devices.net
    IotDeviceId                : srp-007-storagegateway
    EdgeDeviceId               : srp-007-edge
    Version                    :
    Id                         : 6ebeff9f-84c5-49a7-890c-f5e05520a506
    Name                       : IotRole
    Type                       : IOT
    Resources                  : Compute:
                                 MemoryInBytes:34359738368
                                 ProcessorCount:12
                                 VMProfile:
    
                                 Storage:
                                 EndpointMap:
                                 EndpointId:c0721210-23c2-4d16-bca6-c80e171a0781
                                 TargetPath:mysmbedgecloudshare1
                                 Name:mysmbedgecloudshare1
                                 Protocol:SMB
    
                                 EndpointId:6557c3b6-d3c5-4f94-aaa0-6b7313ab5c74
                                 TargetPath:mysmbedgelocalshare
                                 Name:mysmbedgelocalshare
                                 Protocol:SMB
                                 RootFileSystemStorageSizeInBytes:0
    
    HostPlatform               : KubernetesCluster
    State                      : Created
    PlatformType               : Linux
    HostPlatformInstanceId     : 994632cb-853e-41c5-a9cd-05b36ddbb190
    IsHostPlatformOwner        : True
    IsCreated                  : True    
    [10.100.10.10]: PS>
    
  3. A feldolgozó csomópont memória- és processzorértékeinek módosításához futtassa a következő parancsot:

    Set-AzureDataBoxEdgeRoleCompute -Name <Name value from the output of Get-AzureDataBoxEdgeRole> -Memory <Value in Bytes> -ProcessorCount <No. of cores>
    

    Íme egy mintakimenet.

    [10.100.10.10]: PS>Set-AzureDataBoxEdgeRoleCompute -Name IotRole -MemoryInBytes 32GB -ProcessorCount 16
    
    ImageDetail                : Name:mcr.microsoft.com/azureiotedge-agent
                                 Tag:1.0
                                 PlatformType:Linux
    
    EdgeDeviceConnectionString :
    IotDeviceConnectionString  :
    HubHostName                : ase-srp-007.azure-devices.net
    IotDeviceId                : srp-007-storagegateway
    EdgeDeviceId               : srp-007-edge
    Version                    :
    Id                         : 6ebeff9f-84c5-49a7-890c-f5e05520a506
    Name                       : IotRole
    Type                       : IOT
    Resources                  : Compute:
                                 MemoryInBytes:34359738368
                                 ProcessorCount:16
                                 VMProfile:
    
                                 Storage:
                                 EndpointMap:
                                 EndpointId:c0721210-23c2-4d16-bca6-c80e171a0781
                                 TargetPath:mysmbedgecloudshare1
                                 Name:mysmbedgecloudshare1
                                 Protocol:SMB
    
                                 EndpointId:6557c3b6-d3c5-4f94-aaa0-6b7313ab5c74
                                 TargetPath:mysmbedgelocalshare
                                 Name:mysmbedgelocalshare
                                 Protocol:SMB
    
                                 RootFileSystemStorageSizeInBytes:0
    
    HostPlatform               : KubernetesCluster
    State                      : Created
    PlatformType               : Linux
    HostPlatformInstanceId     : 994632cb-853e-41c5-a9cd-05b36ddbb190
    IsHostPlatformOwner        : True
    IsCreated                  : True
    
    [10.100.10.10]: PS>    
    

A memória és a processzorhasználat módosítása során kövesse az alábbi irányelveket.

  • Az alapértelmezett memória az eszköz specifikációjának 25%-a.
  • Az alapértelmezett processzorszám az eszköz specifikációjának 30%-a.
  • A memória és a processzorok számának módosításakor azt javasoljuk, hogy az eszköz memóriájának és a processzorszámnak 15–60%-át módosítsa.
  • A 60%-os felső korlátot javasoljuk, hogy elegendő erőforrás legyen a rendszerösszetevők számára.

Csatlakozás a BMC-be

Feljegyzés

Az alaplapi felügyeleti vezérlő (BMC) nem érhető el az Azure Stack Edge Pro 2-ben és az Azure Stack Edge Mini R-ben. Az ebben a szakaszban ismertetett parancsmagok csak az Azure Stack Edge Pro GPU-ra és az Azure Stack Edge Pro R-re vonatkoznak.

A BMC az eszköz távoli figyelésére és kezelésére szolgál. Ez a szakasz a BMC-konfiguráció kezeléséhez használható parancsmagokat ismerteti. Ezen parancsmagok futtatása előtt Csatlakozás az eszköz PowerShell-felületére.

  • Get-HcsNetBmcInterface: Ezzel a parancsmaggal lekérheti a BMC hálózati konfigurációs tulajdonságait, például: IPv4Address, IPv4Gateway, IPv4SubnetMaskDhcpEnabled.

    Itt látható egy mintakimenet:

    [10.100.10.10]: PS>Get-HcsNetBmcInterface
    IPv4Address   IPv4Gateway IPv4SubnetMask DhcpEnabled
    -----------   ----------- -------------- -----------
    10.128.53.186 10.128.52.1 255.255.252.0        False
    [10.100.10.10]: PS>
    
  • Set-HcsNetBmcInterface: Ezt a parancsmagot a következő két módon használhatja.

    • A parancsmaggal engedélyezheti vagy letilthatja a BMC DHCP-konfigurációját a paraméter megfelelő értékének UseDhcp használatával.

      Set-HcsNetBmcInterface -UseDhcp $true
      

      Itt látható egy mintakimenet:

      [10.100.10.10]: PS>Set-HcsNetBmcInterface -UseDhcp $true
      [10.100.10.10]: PS>Get-HcsNetBmcInterface
      IPv4Address IPv4Gateway IPv4SubnetMask DhcpEnabled
      ----------- ----------- -------------- -----------
      10.128.54.8 10.128.52.1 255.255.252.0         True
      [10.100.10.10]: PS>
      
    • Ezzel a parancsmaggal konfigurálhatja a BMC statikus konfigurációját. Megadhatja az , IPv4AddressIPv4Gatewayés IPv4SubnetMaska .

      Set-HcsNetBmcInterface -IPv4Address "<IPv4 address of the device>" -IPv4Gateway "<IPv4 address of the gateway>" -IPv4SubnetMask "<IPv4 address for the subnet mask>"
      

      Itt látható egy mintakimenet:

      [10.100.10.10]: PS>Set-HcsNetBmcInterface -IPv4Address 10.128.53.186 -IPv4Gateway 10.128.52.1 -IPv4SubnetMask 255.255.252.0
      [10.100.10.10]: PS>Get-HcsNetBmcInterface
      IPv4Address   IPv4Gateway IPv4SubnetMask DhcpEnabled
      -----------   ----------- -------------- -----------
      10.128.53.186 10.128.52.1 255.255.252.0        False
      [10.100.10.10]: PS>
      
  • Set-HcsBmcPassword: Ezzel a parancsmaggal módosíthatja a BMC jelszavát a következőhöz EdgeUser: . A felhasználónév – EdgeUsera kis- és nagybetűk megkülönböztetése.

    Itt látható egy mintakimenet:

    [10.100.10.10]: PS> Set-HcsBmcPassword -NewPassword "Password1"
    [10.100.10.10]: PS>
    

Kilépés a távoli munkamenetből

A távoli PowerShell-munkamenetből való kilépéshez zárja be a PowerShell-ablakot.

Következő lépések