Linux için Azure IoT Edge yükleme veya kaldırmaInstall or uninstall Azure IoT Edge for Linux

Uygulama hedefi:  Evet simgesi IoT Edge 1,1 diğer sürümler: IoT Edge 1,2Applies to: yes icon IoT Edge 1.1 Other versions: IoT Edge 1.2

Uygulama hedefi:  Evet simgesi IoT Edge 1,2 diğer sürümler: IoT Edge 1,1Applies to: yes icon IoT Edge 1.2 Other versions: IoT Edge 1.1

Azure IoT Edge çalışma zamanı, bir cihazı IoT Edge cihazına dönüştürür.The Azure IoT Edge runtime is what turns a device into an IoT Edge device. Çalışma zamanı, cihazlarda Raspberry Pi kadar küçük veya endüstriyel sunucu olarak büyük olarak dağıtılabilir.The runtime can be deployed on devices as small as a Raspberry Pi or as large as an industrial server. Bir cihaz IoT Edge çalışma zamanıyla yapılandırıldığında, buluttan cihaza iş mantığını dağıtmaya başlayabilirsiniz.Once a device is configured with the IoT Edge runtime, you can start deploying business logic to it from the cloud. Daha fazla bilgi edinmek için bkz. Azure IoT Edge çalışma zamanını ve mimarisini anlayın.To learn more, see Understand the Azure IoT Edge runtime and its architecture.

Bu makalede, Linux cihazlarına Azure IoT Edge çalışma zamanını yüklemek için gereken adımlar listelenmektedir.This article lists the steps to install the Azure IoT Edge runtime on Linux devices.

ÖnkoşullarPrerequisites

  • Kayıtlı bir cıhaz kimliğiA registered device ID

    Cihazınızın simetrik anahtar kimlik doğrulaması ile kaydolduysanız, cihaz bağlantı dizesinin hazır olmasını sağlayabilirsiniz.If you registered your device with symmetric key authentication, have the device connection string ready.

    Cihazınızı X. 509.440 otomatik olarak imzalanan sertifika kimlik doğrulaması ile kaydettiniz, cihazı kaydetmek için kullandığınız kimlik sertifikalarından en az birine ve ilgili özel anahtarı cihazınızda kullanılabilir.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.

  • Bir Linux cihazıA Linux device

    X64, ARM32 veya ARM64 Linux cihazı vardır.Have an X64, ARM32, or ARM64 Linux device. Microsoft, Ubuntu Server 18,04 ve Raspberry PI OS Esnetme işletim sistemlerini yükleme paketleri sağlar.Microsoft provides installation packages for Ubuntu Server 18.04 and Raspberry Pi OS Stretch operating systems.

    Şu anda üretim senaryolarında desteklenen işletim sistemleri hakkında en son bilgiler için, bkz. Azure IoT Edge desteklenen sistemlerFor the latest information about which operating systems are currently supported for production scenarios, see Azure IoT Edge supported systems

    Not

    ARM64 cihazlar için destek genel önizlemede.Support for ARM64 devices is in public preview.

  • Cihazınızı Microsoft Yükleme paketlerine erişmek için hazırlayın.Prepare your device to access the Microsoft installation packages.

    Cihaz işletim sisteminizle eşleşen depo yapılandırmasını yükler.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
      
    • Raspberry PI OS Esnetme:Raspberry Pi OS Stretch:

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

    Oluşturulan listeyi sources. List. d dizinine kopyalayın.Copy the generated list to the sources.list.d directory.

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

    Microsoft GPG ortak anahtarını yükler.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 yazılım paketleri, her pakette ( usr/share/doc/{package-name} veya dizinde) bulunan lisans koşullarına tabidir LICENSE .Azure IoT Edge software packages are subject to the license terms located in each package (usr/share/doc/{package-name} or the LICENSE directory). Paket kullanmadan önce lisans koşullarını okuyun.Read the license terms prior to using a package. Bir paketi yüklemeniz ve kullanmanız, bu şartlarınızın kabul edildiğini oluşturur.Your installation and use of a package constitutes your acceptance of these terms. Lisans koşullarını kabul etmiyorsanız, bu paketi kullanmayın.If you do not agree with the license terms, do not use that package.

Kapsayıcı Altyapısı yüklerInstall a container engine

Azure IoT Edge, OCı uyumlu bir kapsayıcı çalışma zamanına bağlıdır.Azure IoT Edge relies on an OCI-compatible container runtime. Üretim senaryolarında Moby altyapısını kullanmanızı öneririz.For production scenarios, we recommended that you use the Moby engine. Moby motoru, Azure IoT Edge ile resmi olarak desteklenen tek kapsayıcı altyapısıdır.The Moby engine is the only container engine officially supported with Azure IoT Edge. Docker CE/EE kapsayıcı görüntüleri Moby çalışma zamanına göre uyumludur.Docker CE/EE container images are compatible with the Moby runtime.

Cihazınızdaki paket listelerini güncelleştirin.Update package lists on your device.

sudo apt-get update

Moby altyapısını yükler.Install the Moby engine.

sudo apt-get install moby-engine

Moby kapsayıcı altyapısını yüklerken hata alırsanız, Moby uyumluluğu için Linux çekirdeğini doğrulayın.If you get errors when installing the Moby container engine, verify your Linux kernel for Moby compatibility. Bazı katıştırılmış cihaz üreticileri, kapsayıcı altyapısı uyumluluğu için gerekli özellikler olmadan özel Linux çekirdekleri içeren cihaz görüntülerini sevk etti.Some embedded device manufacturers ship device images that contain custom Linux kernels without the features required for container engine compatibility. Çekirdek yapılandırmanızı denetlemek için Moby tarafından sunulan Check-config betiğini kullanan aşağıdaki komutu çalıştırın: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

Komut dosyasının çıktısında, ve altındaki tüm öğelerin etkin olduğunu kontrol edin Generally Necessary Network Drivers .In the output of the script, check that all items under Generally Necessary and Network Drivers are enabled. Özellikler eksik ise, çekirdeğini kaynaktan yeniden oluşturarak ve uygun çekirdek. config dosyasına eklenmek üzere ilişkili modülleri seçerek etkinleştirin. Benzer şekilde, veya gibi bir çekirdek yapılandırma Oluşturucu kullanıyorsanız defconfig menuconfig ilgili özellikleri bulup etkinleştirin ve çekirdeğini uygun şekilde yeniden oluşturun.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. Yeni değiştirilen çekirdeğini dağıttıktan sonra, gerekli tüm özelliklerin başarıyla etkinleştirildiğini doğrulamak için Check-config betiğini yeniden çalıştırın.Once you have deployed your newly modified kernel, run the check-config script again to verify that all the required features were successfully enabled.

IoT Edge yüklensinInstall IoT Edge

IoT Edge güvenlik arka plan programı, IoT Edge cihazında güvenlik standartları sağlar ve korur.The IoT Edge security daemon provides and maintains security standards on the IoT Edge device. Arka plan programı her önyüklemede başlar ve IoT Edge çalışma zamanının geri kalanını başlatarak cihazı önyükleme.The daemon starts on every boot and bootstraps the device by starting the rest of the IoT Edge runtime.

Bu bölümdeki adımlarda, internet bağlantısı olan bir cihaza en son sürümü yüklemek için tipik bir işlem temsil etmektedir.The steps in this section represent the typical process to install the latest version on a device that has internet connection. Yayın öncesi sürüm gibi belirli bir sürümü yüklemeniz ya da çevrimdışıyken yüklemeniz gerekiyorsa, bu makalenin ilerleyen kısımlarında yer alarak çevrimdışı veya belirli sürüm yükleme adımlarını izleyin.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.

Cihazınızdaki paket listelerini güncelleştirin.Update package lists on your device.

sudo apt-get update

Hangi IoT Edge sürümlerinin kullanılabilir olduğunu görmek için denetleyin.Check to see which versions of IoT Edge are available.

apt list -a iotedge

Güvenlik arka plan programının en son sürümünü yüklemek istiyorsanız, libiothsm-STD paketinin en son sürümünü de yükleyen aşağıdaki komutu kullanın: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

Ya da güvenlik arka plan programının belirli bir sürümünü yüklemek istiyorsanız, apt liste çıktısından sürümü belirtin.Or, if you want to install a specific version of the security daemon, specify the version from the apt list output. Ayrıca, libiothsm-STD paketi için aynı sürümü belirtin, aksi takdirde en son sürümünü yükler.Also specify the same version for the libiothsm-std package, which otherwise would install its latest version. Örneğin, aşağıdaki komut 1,1 sürümünün en son sürümünü yüklüyor: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*

Yüklemek istediğiniz sürüm listelenmemişse, bu makalenin ilerleyen kısımlarında yer alan çevrimdışı veya belirli sürüm yükleme adımlarını izleyin.If the version that you want to install isn't listed, follow the Offline or specific version installation steps later in this article. Bu bölümde, IoT Edge güvenlik arka plan programının veya sürüm adayı sürümlerinin önceki bir sürümünün nasıl hedeflenecek gösterilmektedir.That section shows you how to target any previous version of the IoT Edge security daemon, or release candidate versions.

IoT Edge hizmeti IoT Edge cihazında güvenlik standartları sağlar ve korur.The IoT Edge service provides and maintains security standards on the IoT Edge device. Hizmet her önyüklemede başlatılır ve IoT Edge çalışma zamanının geri kalanını başlatarak cihazı önyükleme.The service starts on every boot and bootstraps the device by starting the rest of the IoT Edge runtime.

IoT kimlik hizmeti, IoT Edge sürüm 1,2 ile birlikte sunulmuştur.The IoT identity service was introduced along with version 1.2 of IoT Edge. Bu hizmet, IoT Edge için kimlik sağlamayı ve yönetimi ve IoT Hub iletişim kurması gereken diğer cihaz bileşenlerini işler.This service handles the identity provisioning and management for IoT Edge and for other device components that need to communicate with IoT Hub.

Bu bölümdeki adımlarda, internet bağlantısı olan bir cihaza en son sürümü yüklemek için tipik bir işlem temsil etmektedir.The steps in this section represent the typical process to install the latest version on a device that has internet connection. Yayın öncesi sürüm gibi belirli bir sürümü yüklemeniz ya da çevrimdışıyken yüklemeniz gerekiyorsa, bu makalenin ilerleyen kısımlarında yer alarak çevrimdışı veya belirli sürüm yükleme adımlarını izleyin.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.

Not

Bu bölümdeki adımlarda IoT Edge sürüm 1,2 ' nin nasıl yükleneceği gösterilmektedir.The steps in this section show you how to install IoT Edge version 1.2.

Daha eski bir sürümü çalıştıran bir IoT Edge cihazınız zaten varsa ve 1,2 sürümüne yükseltmek istiyorsanız, IoT Edge güvenlik cini ve çalışma zamanını güncelleştirmebölümündeki adımları kullanın.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. Sürüm 1,2, yükseltmek için belirli adımların gerekli olduğu IoT Edge önceki sürümlerinden yeterince farklıdır.Version 1.2 is sufficiently different from previous versions of IoT Edge that specific steps are necessary to upgrade.

Cihazınızdaki paket listelerini güncelleştirin.Update package lists on your device.

sudo apt-get update

Hangi IoT Edge sürümlerinin kullanılabilir olduğunu görmek için denetleyin.Check to see which versions of IoT Edge are available.

apt list -a aziot-edge

En son IoT Edge sürümünü yüklemek istiyorsanız, kimlik hizmeti paketinin en son sürümünü de yükleyen aşağıdaki komutu kullanın: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

Ya da IoT Edge belirli bir sürümünü ve kimlik hizmetini yüklemek istiyorsanız, apt liste çıktısından sürümleri belirtin.Or, if you want to install a specific version of IoT Edge and the identity service, specify the versions from the apt list output. Her iki hizmet için de aynı sürümleri belirtin.Specify the same versions for both services. Örneğin, aşağıdaki komut 1,2 sürümünün en son sürümünü yüklüyor: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*

Cihazı bulut kimliğiyle sağlamaProvision the device with its cloud identity

Artık kapsayıcı altyapısı ve IoT Edge çalışma zamanı cihazınızda yüklü olduğuna göre, bir sonraki adım için hazır olursunuz. Bu, cihazı bulut kimliği ve kimlik doğrulama bilgileriyle ayarlamaya yöneliktir.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.

Kullanmak istediğiniz kimlik doğrulama türüne göre sonraki bölümü seçin:Choose the next section based on which authentication type you want to use:

Seçenek 1: simetrik anahtarlarla kimlik doğrulamaOption 1: Authenticate with symmetric keys

Bu noktada, IoT Edge çalışma zamanı Linux cihazınıza yüklenir ve cihazı bulut kimliği ve kimlik doğrulama bilgileriyle sağlamanız gerekir.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.

Bu bölümde, simetrik anahtar kimlik doğrulaması ile cihaz sağlama adımları gösterilmektedir.This section walks through the steps to provision a device with symmetric key authentication. Cihazınızı IoT Hub kaydolmalı ve cihaz bilgileri 'nden bağlantı dizesini almıştır.You should have registered your device in IoT Hub, and retrieved the connection string from the device information. Aksi takdirde, IoT Hub IoT Edge cihazı kaydetmebölümündeki adımları izleyin.If not, follow the steps in Register an IoT Edge device in IoT Hub.

IoT Edge cihazda yapılandırma dosyasını açın.On the IoT Edge device, open the configuration file.

sudo nano /etc/iotedge/config.yaml

Dosyanın sağlama yapılandırmalarını bulun ve önceden açıklama oluşturulmamış bir bağlantı dizesi bölümü kullanarak el ile sağlama yapılandırmasının açıklamasını kaldırın.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>"

Device_connection_string değerini IoT Edge cihazınızdan bağlantı dizesiyle güncelleştirin.Update the value of device_connection_string with the connection string from your IoT Edge device. Diğer tüm sağlama bölümlerinin açıklama olarak belirlendiğinden emin olun. Sağlama: satırının önünde boşluk olmadığından ve iç içe yerleştirilmiş öğelerin iki boşlukla girintilendiğinden emin olun.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.

Pano içeriğini nano Shift+Right Click veya Press 'e yapıştırmak için Shift+Insert .To paste clipboard contents into Nano Shift+Right Click or press Shift+Insert.

Dosyayı kaydedin ve kapatın.Save and close the file.

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

Yapılandırma dosyasına sağlama bilgilerini girdikten sonra, arka plan programını yeniden başlatın:After entering the provisioning information in the configuration file, restart the daemon:

sudo systemctl restart iotedge

Cihazınızın yapılandırma dosyasını, IoT Edge yüklemesinin bir parçası olarak sağlanmış bir şablon dosyasına göre oluşturun.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

IoT Edge cihazda yapılandırma dosyasını açın.On the IoT Edge device, open the configuration file.

sudo nano /etc/aziot/config.toml

Dosyanın sağlama bölümünü bulun ve bağlantı dizesi satırlarıyla el ile sağlamanın açıklamasını kaldırın.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>"

Connection_string değerini IoT Edge cihazınızdan bağlantı dizesiyle güncelleştirin.Update the value of connection_string with the connection string from your IoT Edge device.

Pano içeriğini nano Shift+Right Click veya Press 'e yapıştırmak için Shift+Insert .To paste clipboard contents into Nano Shift+Right Click or press Shift+Insert.

Dosyayı kaydedin ve kapatın.Save and close the file.

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

Yapılandırma dosyasına sağlama bilgilerini girdikten sonra, değişikliklerinizi uygulayın:After entering the provisioning information in the configuration file, apply your changes:

sudo iotedge config apply

Seçenek 2: X. 509.440 sertifikalarıyla kimlik doğrulamaOption 2: Authenticate with X.509 certificates

Bu noktada, IoT Edge çalışma zamanı Linux cihazınıza yüklenir ve cihazı bulut kimliği ve kimlik doğrulama bilgileriyle sağlamanız gerekir.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.

Bu bölümde, X. 509.440 sertifika kimlik doğrulamasıyla bir cihaz sağlama adımları gösterilmektedir.This section walks through the steps to provision a device with X.509 certificate authentication. Cihazınızı, IoT Edge cihazınızda bulunan sertifikayla ve özel anahtarla eşleşen parmak izleri sağlayan IoT Hub 'ye kaydettiniz.You should have registered your device in IoT Hub, providing thumbprints that match the certificate and private key located on your IoT Edge device. Aksi takdirde, IoT Hub IoT Edge cihazı kaydetmebölümündeki adımları izleyin.If not, follow the steps in Register an IoT Edge device in IoT Hub.

IoT Edge cihazda yapılandırma dosyasını açın.On the IoT Edge device, open the configuration file.

sudo nano /etc/iotedge/config.yaml

Dosyanın sağlama yapılandırmaları bölümünü bulun ve bir X. 509.440 kimlik sertifikası kullanarak el ile sağlama yapılandırmasının açıklamasını kaldırın.Find the provisioning configurations section of the file and uncomment the Manual provisioning configuration using an X.509 identity certificate section. Diğer tüm sağlama bölümlerinin açıklama olarak belirlendiğinden emin olun. Sağlama: satırının önünde boşluk olmadığından ve iç içe yerleştirilmiş öğelerin iki boşlukla girintilendiğinden emin olun.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>"

Aşağıdaki alanları güncelleştirin:Update the following fields:

  • iothub_hostname: cihazın bağlanacağı IoT Hub 'ının ana bilgisayar adı.iothub_hostname: Hostname of the IoT hub the device will connect to. Örneğin, {IoT hub name}.azure-devices.net.For example, {IoT hub name}.azure-devices.net.
  • device_id: cihazı kaydettirdiğiniz sırada verdiğiniz kimlik.device_id: The ID that you provided when you registered the device.
  • identity_cert: cihazdaki bir kimlik sertifikası için URI.identity_cert: URI to an identity certificate on the device. Örneğin, file:///path/identity_certificate.pem.For example, file:///path/identity_certificate.pem.
  • identity_pk: belirtilen kimlik sertifikası için özel anahtar dosyasının URI 'si.identity_pk: URI to the private key file for the provided identity certificate. Örneğin, file:///path/identity_key.pem.For example, file:///path/identity_key.pem.

Dosyayı kaydedin ve kapatın.Save and close the file.

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

Yapılandırma dosyasına sağlama bilgilerini girdikten sonra, arka plan programını yeniden başlatın:After entering the provisioning information in the configuration file, restart the daemon:

sudo systemctl restart iotedge

Cihazınızın yapılandırma dosyasını, IoT Edge yüklemesinin bir parçası olarak sağlanmış bir şablon dosyasına göre oluşturun.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

IoT Edge cihazda yapılandırma dosyasını açın.On the IoT Edge device, open the configuration file.

sudo nano /etc/aziot/config.toml

Dosyanın sağlama bölümünü bulun ve X. 509.440 kimlik sertifikasıyla el ile sağlama için satırların açıklamasını kaldırın.Find the Provisioning section of the file and uncomment the lines for manual provisioning with X.509 identity certificate. Diğer tüm sağlama bölümlerinin açıklama olarak belirlendiğinden emin olun.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>"

Aşağıdaki alanları güncelleştirin:Update the following fields:

  • iothub_hostname: cihazın bağlanacağı IoT Hub 'ının ana bilgisayar adı.iothub_hostname: Hostname of the IoT hub the device will connect to. Örneğin, {IoT hub name}.azure-devices.net.For example, {IoT hub name}.azure-devices.net.
  • device_id: cihazı kaydettirdiğiniz sırada verdiğiniz kimlik.device_id: The ID that you provided when you registered the device.
  • identity_cert: cihazdaki bir kimlik sertifikasının URI 'si, örneğin: file:///path/identity_certificate.pem .identity_cert: URI to an identity certificate on the device, for example: file:///path/identity_certificate.pem. Veya, sertifikayı EST veya yerel bir sertifika yetkilisi kullanarak dinamik olarak verme.Or, dynamically issue the certificate using EST or a local certificate authority.
  • identity_pk: belirtilen kimlik sertifikası için özel anahtar dosyasının URI 'si, örneğin: 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. Ya da bir PKCS # 11 URI 'SI girip yapılandırma bilgilerinizi daha sonra yapılandırma dosyasında PKCS # 11 bölümünde belirtin.Or, provide a PKCS#11 URI and then provide your configuration information in the PKCS#11 section later in the config file.

Dosyayı kaydedin ve kapatın.Save and close the file.

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

Yapılandırma dosyasına sağlama bilgilerini girdikten sonra, değişikliklerinizi uygulayın:After entering the provisioning information in the configuration file, apply your changes:

sudo iotedge config apply

Başarılı yapılandırmayı doğrulaVerify successful configuration

Çalışma zamanının IoT Edge cihazınıza başarıyla yüklenip yapılandırıldığını doğrulayın.Verify that the runtime was successfully installed and configured on your IoT Edge device.

İpucu

iotedge komutlarını çalıştırmak için yükseltilmiş ayrıcalıklara ihtiyacınız olacaktır.You need elevated privileges to run iotedge commands. Makinenizdeki oturumu kapattıktan sonra IoT Edge çalışma zamanını yükleyip oturum açtığınızda izinleriniz otomatik olarak güncelleştirilir.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. Bundan sonra sudo komutların önünde kullanın.Until then, use sudo in front of the commands.

IoT Edge sistem hizmetinin çalışıp çalışmadığını denetleyin.Check to see that the IoT Edge system service is running.

sudo systemctl status iotedge
sudo iotedge system status

Başarılı bir durum yanıtı Ok .A successful status response is Ok.

Hizmetle ilgili sorunları gidermeniz gerekirse hizmet günlüklerini alın.If you need to troubleshoot the service, retrieve the service logs.

journalctl -u iotedge
sudo iotedge system logs

checkAygıtın yapılandırma ve bağlantı durumunu doğrulamak için aracını kullanın.Use the check tool to verify configuration and connection status of the device.

sudo iotedge check

İpucu

sudoİzinleriniz güncelleştirildikten sonra bile denetim aracını çalıştırmak için her zaman kullanın.Always use sudo to run the check tool, even after your permissions are updated. Aracın yapılandırma durumunu doğrulamak için yapılandırma dosyasına erişmesi için yükseltilmiş ayrıcalıklara ihtiyacı vardır.The tool needs elevated privileges to access the config file to verify configuration status.

IoT Edge cihazınızda çalışan tüm modülleri görüntüleyin.View all the modules running on your IoT Edge device. Hizmet ilk kez başladığında yalnızca Edgeagent modülünü çalışır duruma gelmelidir.When the service starts for the first time, you should only see the edgeAgent module running. EdgeAgent modülü varsayılan olarak çalışır ve cihazınıza dağıttığınız ek modüllerin yüklenmesini ve başlamasını sağlar.The edgeAgent module runs by default and helps to install and start any additional modules that you deploy to your device.

sudo iotedge list

Çevrimdışı veya belirli sürümü yükleme (isteğe bağlı)Offline or specific version installation (optional)

Bu bölümdeki adımlar, standart yükleme adımlarının kapsamadığı senaryolar içindir.The steps in this section are for scenarios not covered by the standard installation steps. Bu şunlar olabilir:This may include:

  • Çevrimdışıyken IoT Edge yüklemesiInstall IoT Edge while offline
  • Sürüm Adayı sürümü yüklemesiInstall a release candidate version

Tarafından kullanılamayan Azure IoT Edge çalışma zamanının belirli bir sürümünü yüklemek istiyorsanız bu bölümdeki adımları kullanın 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. Microsoft paket listesi yalnızca sınırlı sayıda yeni sürümü ve alt sürümlerini içerir, bu nedenle bu adımlar daha eski bir sürüm veya sürüm adayı sürümü yüklemek isteyen herkese yöneliktir.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.

Kıvrımlı komutlarını kullanarak bileşen dosyalarını doğrudan IoT Edge GitHub deposundan hedefleyebilirsiniz.Using curl commands, you can target the component files directly from the IoT Edge GitHub repository.

  1. Azure IoT Edge yayınlarınagidin ve hedeflemek istediğiniz yayın sürümünü bulun.Navigate to the Azure IoT Edge releases, and find the release version that you want to target.

  2. Bu sürümün varlıklar bölümünü genişletin.Expand the Assets section for that version.

  3. Her yayında IoT Edge güvenlik Daemon ve hsmlib için yeni dosyalar olmalıdır.Every release should have new files for the IoT Edge security daemon and the hsmlib. Çevrimdışı bir cihaza IoT Edge yükleyecekseniz bu dosyaları daha önce indirin.If you're going to install IoT Edge on an offline device, download these files ahead of time. Aksi takdirde, bu bileşenleri güncelleştirmek için aşağıdaki komutları kullanın.Otherwise, use the following commands to update those components.

    1. IoT Edge cihazınızın mimarisiyle eşleşen libiothsm-STD dosyasını bulun.Find the libiothsm-std file that matches your IoT Edge device's architecture. Dosya bağlantısına sağ tıklayıp bağlantı adresini kopyalayın.Right-click on the file link and copy the link address.

    2. Hsmlib 'in bu sürümünü yüklemek için aşağıdaki komutta bulunan kopyalanmış bağlantıyı kullanın: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. IoT Edge cihazınızın mimarisiyle eşleşen iotedge dosyasını bulun.Find the iotedge file that matches your IoT Edge device's architecture. Dosya bağlantısına sağ tıklayıp bağlantı adresini kopyalayın.Right-click on the file link and copy the link address.

    4. IoT Edge güvenlik arka plan programının bu sürümünü yüklemek için aşağıdaki komutta bulunan kopyalanmış bağlantıyı kullanın.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
      

Not

Cihazınız şu anda IoT Edge sürüm 1,1 veya daha eski sürümlerde çalışıyorsa, bu bölümdeki adımları izleyerek önce ıotedge ve libiothsm-STD paketlerini kaldırın.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. Daha fazla bilgi için bkz. güncelleştirme 1,0 veya 1,1 ile 1,2.For more information, see Update from 1.0 or 1.1 to 1.2.

  1. Azure IoT Edge yayınlarınagidin ve hedeflemek istediğiniz yayın sürümünü bulun.Navigate to the Azure IoT Edge releases, and find the release version that you want to target.

  2. Bu sürümün varlıklar bölümünü genişletin.Expand the Assets section for that version.

  3. Her sürüm IoT Edge ve kimlik hizmeti için yeni dosyalara sahip olmalıdır.Every release should have new files for IoT Edge and the identity service. Çevrimdışı bir cihaza IoT Edge yükleyecekseniz bu dosyaları daha önce indirin.If you're going to install IoT Edge on an offline device, download these files ahead of time. Aksi takdirde, bu bileşenleri güncelleştirmek için aşağıdaki komutları kullanın.Otherwise, use the following commands to update those components.

    1. IoT Edge cihazınızın mimarisiyle eşleşen azıot-Identity-Service dosyasını bulun.Find the aziot-identity-service file that matches your IoT Edge device's architecture. Dosya bağlantısına sağ tıklayıp bağlantı adresini kopyalayın.Right-click on the file link and copy the link address.

    2. Kimlik hizmetinin bu sürümünü yüklemek için aşağıdaki komutta bulunan kopyalanmış bağlantıyı kullanın: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. IoT Edge cihazınızın mimarisiyle eşleşen azıot Edge dosyasını bulun.Find the aziot-edge file that matches your IoT Edge device's architecture. Dosya bağlantısına sağ tıklayıp bağlantı adresini kopyalayın.Right-click on the file link and copy the link address.

    4. Bu IoT Edge sürümünü yüklemek için aşağıdaki komutta bulunan kopyalanmış bağlantıyı kullanın.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
      

Artık kapsayıcı altyapısı ve IoT Edge çalışma zamanı cihazınızda yüklü olduğuna göre, cihazı bulut kimliğiyle sağlamakiçin bir sonraki adıma hazırsınız demektir.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.

IoT Edge kaldırUninstall IoT Edge

IoT Edge yüklemesini cihazınızdan kaldırmak istiyorsanız aşağıdaki komutları kullanın.If you want to remove the IoT Edge installation from your device, use the following commands.

IoT Edge çalışma zamanını kaldırın.Remove the IoT Edge runtime.

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

--purgeYapılandırma dosyalarınız dahil olmak üzere IoT Edge ile ilişkili tüm dosyaları silmek istiyorsanız bayrağını kullanın.Use the --purge flag if you want to delete all the files associated with IoT Edge, including your configuration files. IoT Edge yeniden yüklemek ve gelecekte aynı yapılandırma bilgilerini kullanmak istiyorsanız bu bayrağı bırakın.Leave this flag out if you want to reinstall IoT Edge and use the same configuration information in the future.

IoT Edge çalışma zamanı kaldırıldığında, oluşturduğu kapsayıcılar durdurulur ancak cihazınızda hala bulunur.When the IoT Edge runtime is removed, any containers that it created are stopped but still exist on your device. Hangi olanların kaldığını görmek için tüm kapsayıcıları görüntüleyin.View all containers to see which ones remain.

sudo docker ps -a

İki çalışma zamanı kapsayıcısı dahil olmak üzere cihazınızdaki kapsayıcıları silin.Delete the containers from your device, including the two runtime containers.

sudo docker rm -f <container name>

Son olarak, kapsayıcı çalışma zamanını cihazınızdan kaldırın.Finally, remove the container runtime from your device.

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

Sonraki adımlarNext steps

Modülleri cihazınıza dağıtmayı öğrenmek için IoT Edge modüllerini dağıtmaya devam edin.Continue to deploy IoT Edge modules to learn how to deploy modules onto your device.