Azure Stack Edge Pro GPU-eszköz kezelése a Windows PowerShell használatával
ÉRVÉNYES:Azure Stack Edge Pro – GPUAzure Stack Edge Pro 2Azure Stack Edge Pro RAzure 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élC:\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.
Windows PowerShell-munkamenet futtatása rendszergazdaként.
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.
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.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
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.
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:
Csatlakozás az eszköz PowerShell-felületére.
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
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.
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:
Mielőtt hozzákezd, győződjön meg az alábbiakról:
- Konfigurálta és aktiválta az Azure Stack Edge Pro-eszközt egy Azure Stack Edge-erőforrással az Azure-ban.
- Ezen az eszközön konfigurálta a számítást az Azure Portalon.
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.
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.
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:
Get-HcsApplianceInfo
A parancsmaggal lekérheti az eszköz aktuálisKubernetesPlatform
ésKubernetesWorkloadProfile
beállításait.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>
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.
Csatlakozás az eszköz PowerShell-felületére.
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.
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>
Az IoT Edge-hez kapcsolódó Kubernetes-problémák hibakeresése
Mielőtt hozzákezdene, a következőt kell tennie:
- Számítási hálózat konfigurálva. Lásd : Az Azure Stack Edge Pro hálózatának konfigurálása GPU-val.
- Az eszközön konfigurált számítási szerepkör.
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ő iotedge
parancsok 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 kubectl
kubectl
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 10
haszná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:
Csatlakozás az eszköz PowerShell-felületére.
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ékeit
Name
.Compute
Resources
MemoryInBytes
ésProcessorCount
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>
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
,IPv4SubnetMask
DhcpEnabled
.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 ,
IPv4Address
IPv4Gateway
ésIPv4SubnetMask
a .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özEdgeUser
: . A felhasználónév –EdgeUser
a 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
- Az Azure Stack Edge Pro GPU üzembe helyezése az Azure Portalon.