Instalowanie lub odinstalowywanie Azure IoT Edge dla systemu LinuxInstall or uninstall Azure IoT Edge for Linux

Dotyczy:  ikona tak IoT Edge 1,1 innych wersji: IoT Edge 1,2Applies to: yes icon IoT Edge 1.1 Other versions: IoT Edge 1.2

Dotyczy:  ikona tak IoT Edge 1,2 innych wersji: IoT Edge 1,1Applies to: yes icon IoT Edge 1.2 Other versions: IoT Edge 1.1

Środowisko uruchomieniowe Azure IoT Edge to włączenie urządzenia do urządzenia IoT Edge.The Azure IoT Edge runtime is what turns a device into an IoT Edge device. Środowisko uruchomieniowe można wdrożyć na urządzeniach jako niewielkich jako Raspberry Pi lub jako serwer przemysłowy.The runtime can be deployed on devices as small as a Raspberry Pi or as large as an industrial server. Po skonfigurowaniu urządzenia przy użyciu środowiska uruchomieniowego usługi IoT Edge można rozpocząć wdrażanie na nim logiki biznesowej z chmury.Once a device is configured with the IoT Edge runtime, you can start deploying business logic to it from the cloud. Aby dowiedzieć się więcej, zobacz Omówienie środowiska uruchomieniowego Azure IoT Edge i jego architektury.To learn more, see Understand the Azure IoT Edge runtime and its architecture.

W tym artykule przedstawiono procedurę instalowania środowiska uruchomieniowego Azure IoT Edge na urządzeniach z systemem Linux.This article lists the steps to install the Azure IoT Edge runtime on Linux devices.

Wymagania wstępnePrerequisites

  • Zarejestrowany identyfikator urządzeniaA registered device ID

    Jeśli urządzenie zostało zarejestrowane z uwierzytelnianiem przy użyciu klucza symetrycznego, przygotuj parametry połączenia urządzenia.If you registered your device with symmetric key authentication, have the device connection string ready.

    Jeśli urządzenie zostało zarejestrowane z uwierzytelnianiem za pomocą certyfikatu X. 509 z podpisem własnym, mają co najmniej jeden certyfikat tożsamości, który został użyty do zarejestrowania urządzenia i jego zgodnego klucza prywatnego dostępnego na urządzeniu.If you registered your device with X.509 self-signed certificate authentication, have at least one of the identity certificates that you used to register the device and its matching private key available on your device.

  • Urządzenie z systemem LinuxA Linux device

    Posiadanie urządzenia z systemem Linux lub x64, ARM32 lub ARM64.Have an X64, ARM32, or ARM64 Linux device. Firma Microsoft udostępnia pakiety instalacyjne systemów operacyjnych Ubuntu Server 18,04 i Raspberry Pi w systemie operacyjnym.Microsoft provides installation packages for Ubuntu Server 18.04 and Raspberry Pi OS Stretch operating systems.

    Najnowsze informacje o tym, które systemy operacyjne są obecnie obsługiwane w scenariuszach produkcyjnych, można znaleźć w temacie Azure IoT Edge obsługiwane systemyFor the latest information about which operating systems are currently supported for production scenarios, see Azure IoT Edge supported systems

    Uwaga

    Obsługa urządzeń z ARM64 jest w publicznej wersji zapoznawczej.Support for ARM64 devices is in public preview.

  • Przygotuj urządzenie w celu uzyskania dostępu do pakietów instalacyjnych firmy Microsoft.Prepare your device to access the Microsoft installation packages.

    Zainstaluj konfigurację repozytorium zgodną z systemem operacyjnym urządzenia.Install the repository configuration that matches your device operating system.

    • Ubuntu Server 18,04:Ubuntu Server 18.04:

      curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list
      
    • Rozciąganie systemu operacyjnego Raspberry Pi:Raspberry Pi OS Stretch:

      curl https://packages.microsoft.com/config/debian/stretch/multiarch/prod.list > ./microsoft-prod.list
      

    Skopiuj wytworzoną listę do katalogu sources. list. d.Copy the generated list to the sources.list.d directory.

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/
    

    Zainstaluj klucz publiczny programu Microsoft GPG.Install the Microsoft GPG public key.

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/
    

Azure IoT Edge pakiety oprogramowania podlegają postanowieniom licencyjnym znajdującym się w każdym pakiecie ( usr/share/doc/{package-name} lub LICENSE katalogu).Azure IoT Edge software packages are subject to the license terms located in each package (usr/share/doc/{package-name} or the LICENSE directory). Przeczytaj postanowienia licencyjne przed użyciem pakietu.Read the license terms prior to using a package. Instalacja i użycie pakietu oznacza akceptację tych warunków.Your installation and use of a package constitutes your acceptance of these terms. Jeśli nie akceptujesz postanowień licencyjnych, nie używaj tego pakietu.If you do not agree with the license terms, do not use that package.

Instalowanie aparatu konteneraInstall a container engine

Azure IoT Edge opiera się na zgodnym ze STEROWNIKIem środowiska uruchomieniowego kontenera.Azure IoT Edge relies on an OCI-compatible container runtime. W przypadku scenariuszy produkcyjnych zaleca się użycie aparatu Moby.For production scenarios, we recommended that you use the Moby engine. Aparat Moby jest jedynym aparatem kontenera oficjalnie obsługiwanym przez Azure IoT Edge.The Moby engine is the only container engine officially supported with Azure IoT Edge. Obrazy kontenerów platformy Docker CE/EE są zgodne ze środowiskiem uruchomieniowym Moby.Docker CE/EE container images are compatible with the Moby runtime.

Aktualizowanie list pakietów na urządzeniu.Update package lists on your device.

sudo apt-get update

Zainstaluj aparat Moby.Install the Moby engine.

sudo apt-get install moby-engine

W przypadku wystąpienia błędów podczas instalowania aparatu kontenera Moby należy zweryfikować jądro systemu Linux pod kątem zgodności Moby.If you get errors when installing the Moby container engine, verify your Linux kernel for Moby compatibility. Niektórzy producenci urządzeń osadzonych dostarczają obrazy urządzeń, które zawierają niestandardowe jądra systemu Linux bez funkcji wymaganych do zapewnienia zgodności aparatu kontenera.Some embedded device manufacturers ship device images that contain custom Linux kernels without the features required for container engine compatibility. Uruchom następujące polecenie, które używa skryptu Check-config dostarczonego przez Moby, aby sprawdzić konfigurację jądra:Run the following command, which uses the check-config script provided by Moby, to check your kernel configuration:

curl -sSL https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh -o check-config.sh
chmod +x check-config.sh
./check-config.sh

W danych wyjściowych skryptu Sprawdź, czy wszystkie elementy w obszarze Generally Necessary i Network Drivers są włączone.In the output of the script, check that all items under Generally Necessary and Network Drivers are enabled. Jeśli nie masz żadnych funkcji, włącz je przez przebudowywanie jądra ze źródła i wybranie skojarzonych modułów do uwzględnienia w odpowiednim pliku kernel. config. Podobnie, jeśli używasz generatora konfiguracji jądra, takiego jak defconfig lub menuconfig , Znajdź i Włącz odpowiednie funkcje i odpowiednio Skompiluj jądro.If you are missing features, enable them by rebuilding your kernel from source and selecting the associated modules for inclusion in the appropriate kernel .config. Similarly, if you are using a kernel configuration generator like defconfig or menuconfig, find and enable the respective features and rebuild your kernel accordingly. Po wdrożeniu nowo zmodyfikowanego jądra ponownie uruchom skrypt Check-config, aby sprawdzić, czy wszystkie wymagane funkcje zostały pomyślnie włączone.Once you have deployed your newly modified kernel, run the check-config script again to verify that all the required features were successfully enabled.

Zainstaluj IoT EdgeInstall IoT Edge

Demon Security IoT Edge zapewnia i utrzymuje standardy zabezpieczeń na urządzeniu IoT Edge.The IoT Edge security daemon provides and maintains security standards on the IoT Edge device. Demon jest uruchamiany przy każdym rozruchu i uruchamiania urządzenia przez uruchomienie pozostałej części środowiska uruchomieniowego IoT Edge.The daemon starts on every boot and bootstraps the device by starting the rest of the IoT Edge runtime.

Kroki opisane w tej sekcji przedstawiają typowy proces instalacji najnowszej wersji na urządzeniu z połączeniem internetowym.The steps in this section represent the typical process to install the latest version on a device that has internet connection. Jeśli musisz zainstalować określoną wersję, na przykład wersję wstępną lub zainstalować ją w trybie offline, wykonaj kroki instalacji w trybie offline lub określonej wersji w dalszej części tego artykułu.If you need to install a specific version, like a pre-release version, or need to install while offline, follow the Offline or specific version installation steps later in this article.

Aktualizowanie list pakietów na urządzeniu.Update package lists on your device.

sudo apt-get update

Zaznacz, aby zobaczyć, które wersje IoT Edge są dostępne.Check to see which versions of IoT Edge are available.

apt list -a iotedge

Jeśli chcesz zainstalować najnowszą wersję demona zabezpieczeń, użyj następującego polecenia, które powoduje także zainstalowanie najnowszej wersji pakietu libiothsm-STD :If you want to install the most recent version of the security daemon, use the following command that also installs the latest version of the libiothsm-std package:

sudo apt-get install iotedge

Lub, jeśli chcesz zainstalować określoną wersję demona zabezpieczeń, określ wersję z listy apt danych wyjściowych.Or, if you want to install a specific version of the security daemon, specify the version from the apt list output. Należy również określić tę samą wersję dla pakietu libiothsm-STD , który w przeciwnym razie zainstaluje jego najnowszą wersję.Also specify the same version for the libiothsm-std package, which otherwise would install its latest version. Na przykład następujące polecenie instaluje najnowszą wersję wersji 1,1:For example, the following command installs the most recent version of the 1.1 release:

sudo apt-get install iotedge=1.1* libiothsm-std=1.1*

Jeśli wersja, którą chcesz zainstalować, nie znajduje się na liście, postępuj zgodnie z krokami instalacji w trybie offline lub określonym wersją w dalszej części tego artykułu.If the version that you want to install isn't listed, follow the Offline or specific version installation steps later in this article. W tej sekcji pokazano, jak określić docelową poprzednią wersję demona IoT Edge Security lub wersja Release Candidate.That section shows you how to target any previous version of the IoT Edge security daemon, or release candidate versions.

Usługa IoT Edge zapewnia i utrzymuje standardy zabezpieczeń na urządzeniu IoT Edge.The IoT Edge service provides and maintains security standards on the IoT Edge device. Usługa jest uruchamiana przy każdym rozruchu i uruchamiania na urządzeniu przez uruchomienie pozostałej części środowiska uruchomieniowego IoT Edge.The service starts on every boot and bootstraps the device by starting the rest of the IoT Edge runtime.

Usługa tożsamość IoT została wprowadzona wraz z wersją 1,2 IoT Edge.The IoT identity service was introduced along with version 1.2 of IoT Edge. Ta usługa obsługuje obsługę administracyjną i zarządzanie tożsamościami dla IoT Edge i dla innych składników urządzenia, które muszą komunikować się z IoT Hub.This service handles the identity provisioning and management for IoT Edge and for other device components that need to communicate with IoT Hub.

Kroki opisane w tej sekcji przedstawiają typowy proces instalacji najnowszej wersji na urządzeniu z połączeniem internetowym.The steps in this section represent the typical process to install the latest version on a device that has internet connection. Jeśli musisz zainstalować określoną wersję, na przykład wersję wstępną lub zainstalować ją w trybie offline, wykonaj kroki instalacji w trybie offline lub określonej wersji w dalszej części tego artykułu.If you need to install a specific version, like a pre-release version, or need to install while offline, follow the Offline or specific version installation steps later in this article.

Uwaga

Kroki opisane w tej sekcji pokazują, jak zainstalować program IoT Edge w wersji 1,2.The steps in this section show you how to install IoT Edge version 1.2.

Jeśli masz już urządzenie IoT Edge działające w starszej wersji i chcesz przeprowadzić uaktualnienie do wersji 1,2, wykonaj kroki opisane w temacie Aktualizacja demona IoT Edge Security daemon i środowisko uruchomieniowe.If you already have an IoT Edge device running an older version and want to upgrade to 1.2, use the steps in Update the IoT Edge security daemon and runtime. Wersja 1,2 jest wystarczająco różna od poprzednich wersji IoT Edge, które są niezbędne do uaktualnienia.Version 1.2 is sufficiently different from previous versions of IoT Edge that specific steps are necessary to upgrade.

Aktualizowanie list pakietów na urządzeniu.Update package lists on your device.

sudo apt-get update

Zaznacz, aby zobaczyć, które wersje IoT Edge są dostępne.Check to see which versions of IoT Edge are available.

apt list -a aziot-edge

Jeśli chcesz zainstalować najnowszą wersję IoT Edge, użyj następującego polecenia, które powoduje także zainstalowanie najnowszej wersji pakietu usługi tożsamości:If you want to install the most recent version of IoT Edge, use the following command that also installs the latest version of the identity service package:

sudo apt-get install aziot-edge

Lub, jeśli chcesz zainstalować określoną wersję IoT Edge i usługi tożsamości, określ wersje na podstawie danych wyjściowych listy apt.Or, if you want to install a specific version of IoT Edge and the identity service, specify the versions from the apt list output. Określ te same wersje dla obu usług.Specify the same versions for both services. Na przykład następujące polecenie instaluje najnowszą wersję wersji 1,2:For example, the following command installs the most recent version of the 1.2 release:

sudo apt-get install aziot-edge=1.2* aziot-identity-service=1.2*

Inicjowanie obsługi administracyjnej urządzenia przy użyciu tożsamości w chmurzeProvision the device with its cloud identity

Teraz, gdy aparat kontenera i środowisko uruchomieniowe IoT Edge są zainstalowane na urządzeniu, możesz przejść do następnego kroku, czyli skonfigurować urządzenie przy użyciu tożsamości i informacji o uwierzytelnianiu w chmurze.Now that the container engine and the IoT Edge runtime are installed on your device, you're ready for the next step, which is to set up the device with its cloud identity and authentication information.

Wybierz następną sekcję w zależności od typu uwierzytelniania, którego chcesz użyć:Choose the next section based on which authentication type you want to use:

Opcja 1. uwierzytelnianie przy użyciu kluczy symetrycznychOption 1: Authenticate with symmetric keys

Na tym etapie środowisko uruchomieniowe IoT Edge jest instalowane na urządzeniu z systemem Linux i należy udostępnić je swoje informacje o tożsamości i uwierzytelnianiu w chmurze.At this point, the IoT Edge runtime is installed on your Linux device, and you need to provision the device with its cloud identity and authentication information.

W tej sekcji omówiono procedurę aprowizacji urządzenia z uwierzytelnianiem przy użyciu klucza symetrycznego.This section walks through the steps to provision a device with symmetric key authentication. Urządzenie powinno zostać zarejestrowane w IoT Hub i pobrane parametry połączenia z informacji o urządzeniu.You should have registered your device in IoT Hub, and retrieved the connection string from the device information. W przeciwnym razie wykonaj czynności opisane w temacie Rejestrowanie urządzenia IoT Edge w IoT Hub.If not, follow the steps in Register an IoT Edge device in IoT Hub.

Na urządzeniu IoT Edge Otwórz plik konfiguracji.On the IoT Edge device, open the configuration file.

sudo nano /etc/iotedge/config.yaml

Znajdź konfiguracje aprowizacji pliku i usuń znaczniki ręcznej konfiguracji inicjowania obsługi przy użyciu sekcji parametrów połączenia , jeśli nie została jeszcze odkomentowana.Find the provisioning configurations of the file and uncomment the Manual provisioning configuration using a connection string section, if it isn't already uncommented.

# Manual provisioning configuration using a connection string
provisioning:
  source: "manual"
  device_connection_string: "<ADD DEVICE CONNECTION STRING HERE>"

Zaktualizuj wartość device_connection_string przy użyciu parametrów połączenia z urządzenia IoT Edge.Update the value of device_connection_string with the connection string from your IoT Edge device. Upewnij się, że wszystkie inne sekcje aprowizacji zostały oznaczone jako komentarze. Upewnij się, że funkcja aprowizacji: wiersz nie ma poprzedzającego odstępu i że elementy zagnieżdżone są wcięte o dwie spacje.Make sure that any other provisioning sections are commented out. Make sure the provisioning: line has no preceding whitespace and that nested items are indented by two spaces.

Aby wkleić zawartość schowka do systemu nano Shift+Right Click lub naciśnij klawisz Shift+Insert .To paste clipboard contents into Nano Shift+Right Click or press Shift+Insert.

Zapisz i zamknij plik.Save and close the file.

CTRL + X, Y, EnterCTRL + X, Y, Enter

Po wprowadzeniu informacji o aprowizacji w pliku konfiguracji należy ponownie uruchomić demon:After entering the provisioning information in the configuration file, restart the daemon:

sudo systemctl restart iotedge

Utwórz plik konfiguracji dla urządzenia na podstawie pliku szablonu, który jest dostarczany jako część instalacji IoT Edge.Create the configuration file for your device based on a template file that is provided as part of the IoT Edge installation.

sudo cp /etc/aziot/config.toml.edge.template /etc/aziot/config.toml

Na urządzeniu IoT Edge Otwórz plik konfiguracji.On the IoT Edge device, open the configuration file.

sudo nano /etc/aziot/config.toml

Znajdź sekcję aprowizacji pliku i Usuń komentarz z ręcznej aprowizacji przy użyciu wierszy parametrów połączenia.Find the Provisioning section of the file and uncomment the manual provisioning with connection string lines.

# Manual provisioning with connection string
[provisioning]
source = "manual"
connection_string = "<ADD DEVICE CONNECTION STRING HERE>"

Zaktualizuj wartość connection_string przy użyciu parametrów połączenia z urządzenia IoT Edge.Update the value of connection_string with the connection string from your IoT Edge device.

Aby wkleić zawartość schowka do systemu nano Shift+Right Click lub naciśnij klawisz Shift+Insert .To paste clipboard contents into Nano Shift+Right Click or press Shift+Insert.

Zapisz i zamknij plik.Save and close the file.

CTRL + X, Y, EnterCTRL + X, Y, Enter

Po wprowadzeniu informacji o aprowizacji w pliku konfiguracji Zastosuj zmiany:After entering the provisioning information in the configuration file, apply your changes:

sudo iotedge config apply

Opcja 2: uwierzytelnianie za pomocą certyfikatów X. 509Option 2: Authenticate with X.509 certificates

Na tym etapie środowisko uruchomieniowe IoT Edge jest instalowane na urządzeniu z systemem Linux i należy udostępnić je swoje informacje o tożsamości i uwierzytelnianiu w chmurze.At this point, the IoT Edge runtime is installed on your Linux device, and you need to provision the device with its cloud identity and authentication information.

W tej sekcji omówiono procedurę aprowizacji urządzenia za pomocą uwierzytelniania certyfikatu X. 509.This section walks through the steps to provision a device with X.509 certificate authentication. Urządzenie powinno zostać zarejestrowane w IoT Hub, co zapewnia odciski palców zgodne z certyfikatem i kluczem prywatnym znajdującym się na urządzeniu IoT Edge.You should have registered your device in IoT Hub, providing thumbprints that match the certificate and private key located on your IoT Edge device. W przeciwnym razie wykonaj czynności opisane w temacie Rejestrowanie urządzenia IoT Edge w IoT Hub.If not, follow the steps in Register an IoT Edge device in IoT Hub.

Na urządzeniu IoT Edge Otwórz plik konfiguracji.On the IoT Edge device, open the configuration file.

sudo nano /etc/iotedge/config.yaml

Znajdź sekcję konfiguracje aprowizacji pliku i usuń znaczniki ręcznej konfiguracji inicjowania obsługi przy użyciu certyfikatu tożsamości X. 509 .Find the provisioning configurations section of the file and uncomment the Manual provisioning configuration using an X.509 identity certificate section. Upewnij się, że wszystkie inne sekcje aprowizacji zostały oznaczone jako komentarze. Upewnij się, że funkcja aprowizacji: wiersz nie ma poprzedzającego odstępu i że elementy zagnieżdżone są wcięte o dwie spacje.Make sure that any other provisioning sections are commented out. Make sure the provisioning: line has no preceding whitespace and that nested items are indented by two spaces.

# Manual provisioning configuration using an x.509 identity certificate
provisioning:
  source: "manual"
  authentication:
    method: "x509"
    iothub_hostname: "<REQUIRED IOTHUB HOSTNAME>"
    device_id: "<REQUIRED DEVICE ID PROVISIONED IN IOTHUB>"
    identity_cert: "<REQUIRED URI TO DEVICE IDENTITY CERTIFICATE>"
    identity_pk: "<REQUIRED URI TO DEVICE IDENTITY PRIVATE KEY>"

Zaktualizuj następujące pola:Update the following fields:

  • iothub_hostname: Nazwa hosta Centrum IoT, z którym zostanie nawiązane połączenie.iothub_hostname: Hostname of the IoT hub the device will connect to. Na przykład {IoT hub name}.azure-devices.net.For example, {IoT hub name}.azure-devices.net.
  • device_ID: identyfikator podany podczas rejestrowania urządzenia.device_id: The ID that you provided when you registered the device.
  • identity_cert: identyfikator URI do certyfikatu tożsamości na urządzeniu.identity_cert: URI to an identity certificate on the device. Na przykład file:///path/identity_certificate.pem.For example, file:///path/identity_certificate.pem.
  • identity_pk: identyfikator URI pliku klucza prywatnego dla podanego certyfikatu tożsamości.identity_pk: URI to the private key file for the provided identity certificate. Na przykład file:///path/identity_key.pem.For example, file:///path/identity_key.pem.

Zapisz i zamknij plik.Save and close the file.

CTRL + X, Y, EnterCTRL + X, Y, Enter

Po wprowadzeniu informacji o aprowizacji w pliku konfiguracji należy ponownie uruchomić demon:After entering the provisioning information in the configuration file, restart the daemon:

sudo systemctl restart iotedge

Utwórz plik konfiguracji dla urządzenia na podstawie pliku szablonu, który jest dostarczany jako część instalacji IoT Edge.Create the configuration file for your device based on a template file that is provided as part of the IoT Edge installation.

sudo cp /etc/aziot/config.toml.edge.template /etc/aziot/config.toml

Na urządzeniu IoT Edge Otwórz plik konfiguracji.On the IoT Edge device, open the configuration file.

sudo nano /etc/aziot/config.toml

Znajdź sekcję aprowizacji pliku i usuń znaczniki komentarza z wierszy do ręcznego inicjowania obsługi przy użyciu certyfikatu tożsamości X. 509.Find the Provisioning section of the file and uncomment the lines for manual provisioning with X.509 identity certificate. Upewnij się, że wszystkie inne sekcje aprowizacji zostały oznaczone jako komentarze.Make sure that any other provisioning sections are commented out.

# Manual provisioning with x.509 certificates
[provisioning]
source = "manual"
iothub_hostname = "<REQUIRED IOTHUB HOSTNAME>"
device_id = "<REQUIRED DEVICE ID PROVISIONED IN IOTHUB>"

[provisioning.authentication]
method = "x509"

identity_cert = "<REQUIRED URI OR POINTER TO DEVICE IDENTITY CERTIFICATE>"

identity_pk = "<REQUIRED URI TO DEVICE IDENTITY PRIVATE KEY>"

Zaktualizuj następujące pola:Update the following fields:

  • iothub_hostname: Nazwa hosta Centrum IoT, z którym zostanie nawiązane połączenie.iothub_hostname: Hostname of the IoT hub the device will connect to. Na przykład {IoT hub name}.azure-devices.net.For example, {IoT hub name}.azure-devices.net.
  • device_ID: identyfikator podany podczas rejestrowania urządzenia.device_id: The ID that you provided when you registered the device.
  • identity_cert: identyfikator URI do certyfikatu tożsamości na urządzeniu, na przykład: file:///path/identity_certificate.pem .identity_cert: URI to an identity certificate on the device, for example: file:///path/identity_certificate.pem. Lub dynamicznie wystawić certyfikat przy użyciu narzędzia EST lub lokalnego urzędu certyfikacji.Or, dynamically issue the certificate using EST or a local certificate authority.
  • identity_pk: identyfikator URI pliku klucza prywatnego dla podanego certyfikatu tożsamości, na przykład: file:///path/identity_key.pem .identity_pk: URI to the private key file for the provided identity certificate, for example: file:///path/identity_key.pem. Lub podaj identyfikator URI PKCS # 11, a następnie podaj informacje konfiguracyjne w sekcji PKCS # 11 później w pliku konfiguracyjnym.Or, provide a PKCS#11 URI and then provide your configuration information in the PKCS#11 section later in the config file.

Zapisz i zamknij plik.Save and close the file.

CTRL + X, Y, EnterCTRL + X, Y, Enter

Po wprowadzeniu informacji o aprowizacji w pliku konfiguracji Zastosuj zmiany:After entering the provisioning information in the configuration file, apply your changes:

sudo iotedge config apply

Weryfikuj pomyślną konfiguracjęVerify successful configuration

Sprawdź, czy środowisko uruchomieniowe zostało pomyślnie zainstalowane i skonfigurowane na urządzeniu usługi IoT Edge.Verify that the runtime was successfully installed and configured on your IoT Edge device.

Porada

Uruchomienie poleceń iotedge wymaga podniesionych uprawnień.You need elevated privileges to run iotedge commands. Po wylogowaniu się z komputera i ponownym zalogowaniu się do niego po raz pierwszy od zainstalowania środowiska uruchomieniowego usługi IoT Edge Twoje uprawnienia zostaną automatycznie zaktualizowane.Once you sign out of your machine and sign back in the first time after installing the IoT Edge runtime, your permissions are automatically updated. Do tego momentu należy użyć sudo przed poleceniami.Until then, use sudo in front of the commands.

Sprawdź, czy usługa systemowa IoT Edge jest uruchomiona.Check to see that the IoT Edge system service is running.

sudo systemctl status iotedge
sudo iotedge system status

Odpowiedź dotycząca stanu powiodła się Ok .A successful status response is Ok.

Jeśli potrzebujesz rozwiązać problem z usługą, pobierz jej dzienniki.If you need to troubleshoot the service, retrieve the service logs.

journalctl -u iotedge
sudo iotedge system logs

Użyj check Narzędzia, aby zweryfikować konfigurację i stan połączenia urządzenia.Use the check tool to verify configuration and connection status of the device.

sudo iotedge check

Porada

Zawsze używaj sudo , aby uruchomić narzędzie sprawdzania, nawet po zaktualizowaniu uprawnień.Always use sudo to run the check tool, even after your permissions are updated. Narzędzie wymaga podniesionych uprawnień, aby uzyskać dostęp do pliku konfiguracji w celu sprawdzenia stanu konfiguracji.The tool needs elevated privileges to access the config file to verify configuration status.

Wyświetl wszystkie moduły uruchomione na urządzeniu usługi IoT Edge.View all the modules running on your IoT Edge device. Gdy usługa jest uruchamiana po raz pierwszy, powinien być widoczny tylko uruchomiony moduł edgeAgent .When the service starts for the first time, you should only see the edgeAgent module running. Moduł edgeAgent jest domyślnie uruchamiany i ułatwia Instalowanie i uruchamianie wszelkich dodatkowych modułów wdrażanych na urządzeniu.The edgeAgent module runs by default and helps to install and start any additional modules that you deploy to your device.

sudo iotedge list

Instalacja w trybie offline lub określona wersja (opcjonalnie)Offline or specific version installation (optional)

Kroki opisane w tej sekcji dotyczą scenariuszy nieuwzględnionych w standardowych krokach instalacji.The steps in this section are for scenarios not covered by the standard installation steps. Może to obejmować:This may include:

  • Zainstaluj IoT Edge w trybie offlineInstall IoT Edge while offline
  • Zainstaluj wersję Release CandidateInstall a release candidate version

Wykonaj kroki opisane w tej sekcji, jeśli chcesz zainstalować konkretną wersję środowiska uruchomieniowego Azure IoT Edge, która nie jest dostępna w programie apt-get install .Use the steps in this section if you want to install a specific version of the Azure IoT Edge runtime that isn't available through apt-get install. Lista pakietów firmy Microsoft zawiera tylko ograniczony zestaw najnowszych wersji i ich wersje podrzędne, dlatego te kroki są przeznaczone dla wszystkich osób, które chcą zainstalować starszą wersję lub wersję programu Release Candidate.The Microsoft package list only contains a limited set of recent versions and their sub-versions, so these steps are for anyone who wants to install an older version or a release candidate version.

Korzystając z poleceń zwinięcie, można kierować pliki składników bezpośrednio z repozytorium IoT Edge GitHub.Using curl commands, you can target the component files directly from the IoT Edge GitHub repository.

  1. Przejdź do wydań Azure IoT Edgei Znajdź wersję wydania, która ma być docelowa.Navigate to the Azure IoT Edge releases, and find the release version that you want to target.

  2. Rozwiń sekcję zasobów dla tej wersji.Expand the Assets section for that version.

  3. Każde wydanie powinno mieć nowe pliki dla IoT Edge Security daemon i hsmlib.Every release should have new files for the IoT Edge security daemon and the hsmlib. Jeśli zamierzasz zainstalować IoT Edge na urządzeniu w trybie offline, Pobierz te pliki przed czasem.If you're going to install IoT Edge on an offline device, download these files ahead of time. W przeciwnym razie użyj następujących poleceń, aby zaktualizować te składniki.Otherwise, use the following commands to update those components.

    1. Znajdź plik libiothsm-STD zgodny z architekturą urządzenia IoT Edge.Find the libiothsm-std file that matches your IoT Edge device's architecture. Kliknij prawym przyciskiem myszy link do pliku i skopiuj adres łącza.Right-click on the file link and copy the link address.

    2. Użyj skopiowanego linku w poniższym poleceniu, aby zainstalować tę wersję hsmlib:Use the copied link in the following command to install that version of the hsmlib:

      curl -L <libiothsm-std link> -o libiothsm-std.deb && sudo apt-get install ./libiothsm-std.deb
      
    3. Znajdź plik iotedge , który jest zgodny z architekturą urządzenia IoT Edge.Find the iotedge file that matches your IoT Edge device's architecture. Kliknij prawym przyciskiem myszy link do pliku i skopiuj adres łącza.Right-click on the file link and copy the link address.

    4. Aby zainstalować tę wersję demona zabezpieczeń IoT Edge, użyj skopiowanego linku w poniższym poleceniu.Use the copied link in the following command to install that version of the IoT Edge security daemon.

      curl -L <iotedge link> -o iotedge.deb && sudo apt-get install ./iotedge.deb
      

Uwaga

Jeśli urządzenie jest aktualnie uruchomione IoT Edge wersji 1,1 lub starszej, Odinstaluj pakiety iotedge i libiothsm-STD przed wykonaniem kroków opisanych w tej sekcji.If your device is currently running IoT Edge version 1.1 or older, uninstall the iotedge and libiothsm-std packages before following the steps in this section. Aby uzyskać więcej informacji, zobacz Aktualizacja z 1,0 lub 1,1 do 1,2.For more information, see Update from 1.0 or 1.1 to 1.2.

  1. Przejdź do wydań Azure IoT Edgei Znajdź wersję wydania, która ma być docelowa.Navigate to the Azure IoT Edge releases, and find the release version that you want to target.

  2. Rozwiń sekcję zasobów dla tej wersji.Expand the Assets section for that version.

  3. Każde wydanie powinno mieć nowe pliki dla IoT Edge i usługi tożsamości.Every release should have new files for IoT Edge and the identity service. Jeśli zamierzasz zainstalować IoT Edge na urządzeniu w trybie offline, Pobierz te pliki przed czasem.If you're going to install IoT Edge on an offline device, download these files ahead of time. W przeciwnym razie użyj następujących poleceń, aby zaktualizować te składniki.Otherwise, use the following commands to update those components.

    1. Znajdź plik aziot-Identity-Service pasujący do architektury urządzenia IoT Edge.Find the aziot-identity-service file that matches your IoT Edge device's architecture. Kliknij prawym przyciskiem myszy link do pliku i skopiuj adres łącza.Right-click on the file link and copy the link address.

    2. Użyj skopiowanego linku w poniższym poleceniu, aby zainstalować tę wersję usługi tożsamości:Use the copied link in the following command to install that version of the identity service:

      curl -L <identity service link> -o aziot-identity-service.deb && sudo apt-get install ./aziot-identity-service.deb
      
    3. Znajdź plik aziot-Edge pasujący do architektury urządzenia IoT Edge.Find the aziot-edge file that matches your IoT Edge device's architecture. Kliknij prawym przyciskiem myszy link do pliku i skopiuj adres łącza.Right-click on the file link and copy the link address.

    4. Użyj skopiowanego linku w poniższym poleceniu, aby zainstalować tę wersję programu IoT Edge.Use the copied link in the following command to install that version of IoT Edge.

      curl -L <iotedge link> -o aziot-edge.deb && sudo apt-get install ./aziot-edge.deb
      

Teraz, gdy aparat kontenerów i środowisko uruchomieniowe IoT Edge są zainstalowane na urządzeniu, możesz przystąpić do następnego kroku, który polega na udostępnieniu urządzenia w jego tożsamości w chmurze.Now that the container engine and the IoT Edge runtime are installed on your device, you're ready for the next step, which is to Provision the device with its cloud identity.

Odinstaluj IoT EdgeUninstall IoT Edge

Jeśli chcesz usunąć instalację IoT Edge z urządzenia, użyj następujących poleceń.If you want to remove the IoT Edge installation from your device, use the following commands.

Usuń środowisko uruchomieniowe usługi IoT Edge.Remove the IoT Edge runtime.

sudo apt-get remove iotedge
sudo apt-get remove aziot-edge

Użyj --purge flagi, aby usunąć wszystkie pliki skojarzone z IoT Edge, w tym pliki konfiguracji.Use the --purge flag if you want to delete all the files associated with IoT Edge, including your configuration files. Pozostaw tę flagę, jeśli chcesz ponownie zainstalować IoT Edge i korzystać z tych samych informacji konfiguracyjnych w przyszłości.Leave this flag out if you want to reinstall IoT Edge and use the same configuration information in the future.

Po usunięciu środowiska uruchomieniowego IoT Edge wszystkie utworzone kontenery zostaną zatrzymane, ale nadal istnieją na urządzeniu.When the IoT Edge runtime is removed, any containers that it created are stopped but still exist on your device. Wyświetl wszystkie kontenery, aby zobaczyć, które pozostaną.View all containers to see which ones remain.

sudo docker ps -a

Usuń kontenery z urządzenia, w tym dwa kontenery środowiska uruchomieniowego.Delete the containers from your device, including the two runtime containers.

sudo docker rm -f <container name>

Na koniec Usuń środowisko uruchomieniowe kontenera z urządzenia.Finally, remove the container runtime from your device.

sudo apt-get remove --purge moby-cli
sudo apt-get remove --purge moby-engine

Następne krokiNext steps

Kontynuuj wdrażanie modułów IoT Edge , aby dowiedzieć się, jak wdrażać moduły na urządzeniu.Continue to deploy IoT Edge modules to learn how to deploy modules onto your device.