Menyebarkan Windows berbasis ekstensi atau Hybrid Runbook Worker Pengguna Linux di Azure Automation (Pratinjau)

  • Artikel
  • 13 menit untuk membaca

Onboarding berbasis ekstensi hanya untuk Pengguna Hybrid Runbook Worker. Artikel ini menjelaskan cara menyebarkan pengguna Hybrid Runbook Worker pada komputer Windows atau Linux, menghapus pekerja, dan menghapus grup Hybrid Runbook Worker.

Untuk onboarding Sistem Hybrid Runbook Worker, lihat Menyebarkan Windows Hybrid Runbook Worker berbasis agen di Azure Automation atau Menyebarkan Hybrid Runbook Worker Linux berbasis agen di Azure Automation.

Anda dapat menggunakan fitur Hybrid Runbook Worker pengguna dari Azure Automation untuk menjalankan runbook langsung di komputer Azure maupun non-Azure, termasuk server yang terdaftar di server yang didukung Azure Arc. Dari mesin atau server yang menghosting peran, Anda dapat menjalankan runbook langsung terhadap mesin atau server dan terhadap sumber daya di lingkungan untuk mengelola sumber daya lokal tersebut.

Azure Automation menyimpan dan mengelola runbook, kemudian mengirimkannya ke satu atau beberapa komputer yang dipilih. Setelah Anda berhasil menyebarkan pekerja runbook, ulas Jalankan runbook pada Hybrid Runbook Worker guna mempelajari cara mengonfigurasi runbook Anda untuk mengotomatiskan proses di pusat data lokal Anda atau lingkungan cloud lainnya.

Catatan

Hybrid worker dapat hidup berdampingan dengan kedua platform: Agen berbasis (V1) dan Ekstensi berbasis(V2) . Jika Anda menginstal Extension based (V2)pada hybrid worker yang sudah menjalankan Agent based (V1), maka Anda akan melihat dua entri Hybrid Runbook Worker dalam grup. Satu dengan Platform Ekstensi berbasis (V2) dan lainnya Agen berbasis (V1) . Pelajari selengkapnya.

Prasyarat

Persyaratan minimum komputer

  • Dua core
  • RAM 4 GB
  • Identitas terkelola yang ditetapkan sistem harus diaktifkan di komputer virtual Azure atau server berkemampuan Arc. Jika identitas terkelola yang ditetapkan sistem tidak diaktifkan, maka akan diaktifkan sebagai bagian dari proses penambahan.
  • Komputer non-Azure harus memiliki agen server yang diaktifkan Azure Arc (agen mesin yang terhubung) terinstal. Untuk menginstal AzureConnectedMachineAgent, lihat Koneksi komputer hibrid ke Azure dari portal Azure.

Sistem operasi yang didukung

Windows Linux (x64)
● Windows Server 2022 (termasuk Server Core)
● Windows Server 2019 (termasuk Server Core)
● Windows Server 2016, versi 1709 dan 1803 (tidak termasuk Server Core), dan
● Windows Server 2012, 2012 R2		 ● Debian GNU/Linux 7 dan 8
● Ubuntu 18.04, dan 20.04 LTS
● SUSE Linux Enterprise Server 15, dan 15.1 (SUSE tidak merilis versi bernomor 13 atau 14), dan
● Red Hat Enterprise Linux Server 7 dan 8

Persyaratan Lainnya

Windows Linux (x64)
Windows PowerShell 5.1(unduh WMF 5.1). PowerShell Core tidak didukung. Pengerasan Linux tidak boleh diaktifkan. 
.NET Framework 4.6.2 atau yang lebih baru. 

Persyaratan paket untuk Linux

Paket yang diperlukan Deskripsi Versi minimum
Glibc GNU C Library 2.5-12
Openssl OpenSSL Libraries 1.0 (TLS 1.1, dan TLS 1.2 yang didukung)
Curl Klien web cURL 7.15.5
Python-ctypes Pustaka fungsi asing untuk Python Python 2.x atau Python 3.x diperlukan
PAM Modul Autentikasi yang Dapat Dicocokkan
Paket opsional Deskripsi Versi minimum
PowerShell Core Untuk menjalankan runbook PowerShell, PowerShell Core perlu dipasang. Untuk petunjuk, lihat Memasang PowerShell Core di Linux 6.0.0

Persyaratan jaringan

Penggunaan server proksi

Jika Anda menggunakan server proksi untuk komunikasi antara Azure Automation dan komputer yang menjalankan Hybrid Runbook Worker berbasis ekstensi, pastikan bahwa sumber daya yang sesuai dapat diakses. Batas waktu untuk permintaan dari layanan Hybrid Runbook Worker dan Automation adalah 30 detik. Setelah tiga upaya, permintaan gagal.

Catatan

Anda dapat menyiapkan pengaturan proksi oleh cmdlet atau API PowerShell.

Untuk menginstal ekstensi menggunakan cmdlet:

  1. Dapatkan detail akun otomatisasi menggunakan panggilan API di bawah ini.

    GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}?api-version=2021-06-22

    Panggilan API akan memberikan nilai dengan kunci: AutomationHybridServiceUrl. Gunakan URL di langkah berikutnya untuk mengaktifkan ekstensi pada VM.

  2. Instal Ekstensi Hybrid Worker pada VM dengan menjalankan cmdlet PowerShell berikut (Modul yang diperlukan: Az.Compute). Gunakan yang properties.automationHybridServiceUrl disediakan oleh panggilan API di atas

Pengaturan server proksi

$settings = @{
    "AutomationAccountURL"  = "<registrationurl>/<subscription-id>";    
    "ProxySettings" = @{
        "ProxyServer" = "<ipaddress>:<port>";
        "UserName"="test";
    }
};
$protectedsettings = @{
"ProxyPassword" = "password";
};

VM Azure

Set-AzVMExtension -ResourceGroupName <VMResourceGroupName> -Location <VMLocation> -VMName <VMName> -Name "HybridWorkerExtension" -Publisher "Microsoft.Azure.Automation.HybridWorker" -ExtensionType HybridWorkerForWindows -TypeHandlerVersion 0.1 -Settings $settings

VM dengan dukungan Azure Arc

New-AzConnectedMachineExtension -ResourceGroupName <VMResourceGroupName> -Location <VMLocation> -MachineName <VMName> -Name "HybridWorkerExtension" -Publisher "Microsoft.Azure.Automation.HybridWorker" -ExtensionType HybridWorkerForWindows -TypeHandlerVersion 0.1 -Setting $settings -NoWait

Penggunaan firewall

Jika menggunakan firewall untuk membatasi akses ke internet, Anda harus mengonfigurasi firewall untuk mengizinkan akses. Port dan URL berikut diperlukan untuk Hybrid Runbook Worker, dan untuk Konfigurasi Status Automation untuk berkomunikasi dengan Azure Automation.

Properti Deskripsi
Port 443 untuk akses internet keluar
URL Global *.azure-automation.net
URL Global US Gov Virginia *.azure-automation.us

Batas kuota CPU

Ada batas kuota CPU 5% saat mengonfigurasi pekerja Linux Hybrid Runbook berbasis ekstensi. Tidak ada batasan untuk Windows Hybrid Runbook Worker.

Membuat grup hybrid worker

Anda dapat membuat Grup Hybrid Worker melalui portal Azure. Saat ini, pembuatan melalui templat Azure Resource Manager (ARM) tidak didukung.

Untuk membuat grup hybrid worker di portal Azure, ikuti langkah-langkah berikut:

  1. Masuk ke portal Azure.

  2. Buka akun Automasi Anda.

  3. Di bagian Azure Automation Proses, pilih Grup hybrid worker.

  4. Pilih + Buat grup hybrid worker.

    Screenshot showing to select hybrid Worker Groups option in portal.

  5. Dari tab Dasar , dalam kotak teks Nama , masukkan nama untuk grup Hybrid worker Anda.

  6. Untuk opsi Gunakan Kredensial Hybrid Worker :

    • Jika Anda memilih Default, ekstensi hibrid akan diinstal menggunakan akun sistem lokal.
    • Jika Anda memilih Kustom, lalu dari daftar drop-down, pilih aset kredensial.

  7. Pilih Berikutnya untuk melanjutkan ke tab Hybrid workers. Anda dapat memilih mesin virtual Azure atau server yang didukung Azure Arc untuk ditambahkan ke grup Hybrid worker ini. Jika Anda tidak memilih mesin apa pun, grup Hybrid worker kosong akan dibuat. Anda masih bisa menambahkan mesin nanti.

    Screenshot showing to enter name and credentials in basics tab.

  8. Pilih Tambahkan mesin untuk membuka halaman Tambahkan mesin sebagai hybrid worker. Anda hanya akan melihat mesin yang bukan bagian dari grup hybrid worker lainnya.

  9. Pilih kotak centang di samping mesin yang ingin Anda tambahkan ke grup hybrid worker. Jika Anda tidak melihat komputer non-Azure Anda terdaftar, pastikan agen Azure Arc Connected Machine diinstal pada komputer.

  10. Pilih Tambahkan.

  11. Pilih Lanjut untuk berpindah ke tab Tinjau + Buat.

  12. Pilih Buat.

    Ekstensi hybrid worker dipasang pada komputer dan hybrid worker terdaftar ke grup hybrid worker. Penambahan hybrid worker ke grup akan segera terjadi, sementara penginstalan ekstensi mungkin memakan waktu beberapa menit. Pilih Refresh untuk melihat grup baru. Pilih nama grup untuk menampilkan detail hybrid worker.

    Catatan

    Komputer yang dipilih tidak akan ditambahkan ke grup hybrid worker jika sudah menjadi bagian dari grup hybrid worker lain.

Menambahkan komputer ke grup hybrid worker

Anda juga dapat menambahkan komputer ke grup hybrid worker yang ada.

  1. Di bagian Azure Automation Proses, pilih Grup hybrid worker, lalu grup hybrid worker Anda yang ada untuk membuka halaman Grup Hybrid Worker.

  2. Di bagian Grup hybrid worker, pilih Hybrid Worker.

  3. Pilih + Tambahkan untuk membuka halaman Tambahkan komputer sebagai hybrid worker. Anda hanya akan melihat mesin yang bukan bagian dari grup hybrid worker lainnya.

    Screenshot showing the Add button to add machines to existing group.

  4. Pilih kotak centang di samping mesin yang ingin Anda tambahkan ke grup hybrid worker.

    Jika Anda tidak melihat komputer non-Azure Anda terdaftar, pastikan agen Azure Arc Connected Machine diinstal pada komputer.

  5. Pilih Tambahkan untuk menambahkan komputer ke grup.

    Setelah ditambahkan, Anda dapat melihat jenis komputer sebagai mesin virtual Azure atau server yang didukung Arc. Bidang Platform menunjukkan pekerja sebagai Agen berbasis (V1) atau Ekstensi berbasis (V2) .

    Platform field showing agent or extension based.

Instal Berbasis Ekstensi (V2) pada Hybrid Worker berbasis Agen (V1) yang ada

Hybrid worker dapat hidup berdampingan dengan kedua platform: Agen berbasis (V1) dan Ekstensi berbasis(V2) . Untuk menginstal Ekstensi berbasis (V2) pada pekerja hibrid yang sudah memiliki berbasis Agen (V1):

  1. Di bawah Otomatisasi Proses, pilih Grup Hybrid Worker, lalu grup hybrid worker Anda yang sudah ada untuk masuk ke halaman Grup Hybrid Worker .
  2. Di bagian Grup hybrid worker, pilih Hybrid Worker.
  3. Pilih + Tambahkan untuk membuka halaman Tambahkan komputer sebagai hybrid worker.
  4. Pilih kotak centang di samping Pekerja hibrid berbasis Agen (V1) yang sudah ada.
  5. Pilih Tambahkan untuk menambahkan komputer ke grup.

Kolom Platform menunjukkan pekerja yang sama dengan berbasis Agen (V1) dan Berbasis ekstensi (V2). Hapus Hybrid Worker berbasis Agen (V1) setelah Anda yakin tentang cara kerja pekerja berbasis Ekstensi (V2).

Menghapus Hybrid Runbook Worker

Anda dapat menghapus Hybrid Runbook Worker dari portal.

  1. Di bagian Azure Automation Proses, pilih Grup hybrid worker lalu grup hybrid worker Anda untuk membuka halaman Grup Hybrid Worker.

  2. Di bagian Grup hybrid worker, pilih Hybrid Worker.

  3. Pilih kotak centang di samping komputer yang ingin Anda hapus dari grup hybrid worker.

  4. Pilih Hapus.

    Anda akan diberi peringatan di kotak dialog Hapus Hybrid worker bahwa hybrid worker yang dipilih akan dihapus secara permanen. Pilih Hapus. Operasi ini akan menghapus ekstensi untuk pekerja Ekstensi berbasis (V2) atau menghapus entri Agen berbasis (V1) dari portal. Namun, tindakan tersebut meninggalkan hybrid worker yang kedaluarsa di VM. Untuk mencopot pemasangan agen secara manual, lihat Mencopot pemasangan agen.

    Screenshot showing to delete virtual machine from existing group.

    Catatan

    • Hybrid worker dapat hidup berdampingan dengan kedua platform: Agen berbasis (V1) dan Ekstensi berbasis(V2) . Jika Anda menginstal Ekstensi berbasis (V2) pada hybrid worker yang sudah menjalankan Agent berbasis (V1) , maka Anda akan melihat dua entri Hybrid Runbook Worker dalam grup. Satu dengan Platform Ekstensi berbasis (V2) dan lainnya Agen berbasis (V1) .

    • Setelah Anda menonaktifkan Private Link di akun Automation Anda, mungkin perlu waktu hingga 60 menit untuk menghapus pekerja Hybrid Runbook.

Hapus grup Hybrid Runbook Worker

Anda dapat menghapus grup Hybrid Runbook Worker yang kosong dari portal.

  1. Di bagian Azure Automation Proses, pilih Grup hybrid worker lalu grup hybrid worker Anda untuk membuka halaman Grup Hybrid Worker.

  2. Pilih Hapus.

    Pesan peringatan tampaknya menghapus komputer apa pun yang didefinisikan sebagai pekerja hibrid di grup hybrid worker. Jika sudah ada pekerja yang ditambahkan ke grup, Anda harus terlebih dahulu menghapus pekerja dari grup.

  3. Pilih Ya.

    Grup hybrid worker akan dihapus.

Templat Azure Resource Manager

Anda dapat menggunakan templat Azure Resource Manager (ARM) untuk membuat VM Azure Windows baru serta menyambungkannya ke akun Azure Automation yang ada dan Grup Hybrid Worker. Untuk mempelajari lebih lanjut tentang templat ARM, lihat Apa itu templat ARM?

Meninjau templat

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "automationAccount": {
      "type": "string"
    },
    "automationAccountLocation": {
      "type": "string"
    },
    "workerGroupName": {
      "type": "string"
    },
    "virtualMachineName": {
      "type": "string",
      "defaultValue": "simple-vm",
      "metadata": {
        "description": "Name of the virtual machine."
      }
    },
    "adminUsername": {
      "type": "string",
      "metadata": {
        "description": "Username for the Virtual Machine."
      }
    },
    "adminPassword": {
      "type": "securestring",
      "minLength": 12,
      "metadata": {
        "description": "Password for the Virtual Machine."
      }
    },
    "vmLocation": {
      "type": "string",
      "defaultValue": "North Central US",
      "metadata": {
        "description": "Location for the VM."
      }
    },
    "vmSize": {
      "type": "string",
      "defaultValue": "Standard_DS1_v2",
      "metadata": {
        "description": "Size of the virtual machine."
      }
    },
    "osVersion": {
      "type": "string",
      "defaultValue": "2019-Datacenter",
      "allowedValues": [
        "2008-R2-SP1",
        "2012-Datacenter",
        "2012-R2-Datacenter",
        "2016-Nano-Server",
        "2016-Datacenter-with-Containers",
        "2016-Datacenter",
        "2019-Datacenter",
        "2019-Datacenter-Core",
        "2019-Datacenter-Core-smalldisk",
        "2019-Datacenter-Core-with-Containers",
        "2019-Datacenter-Core-with-Containers-smalldisk",
        "2019-Datacenter-smalldisk",
        "2019-Datacenter-with-Containers",
        "2019-Datacenter-with-Containers-smalldisk"
      ],
      "metadata": {
        "description": "The Windows version for the VM. This will pick a fully patched image of this given Windows version."
      }
    },
    "dnsNameForPublicIP": {
      "type": "string",
      "metadata": {
        "description": "DNS name for the public IP"
      }
    },
    "_CurrentDateTimeInTicks": {
      "type": "string",
      "defaultValue": "[utcNow('yyyy-MM-dd')]"
    }
  },
  "variables": {
    "nicName": "myVMNict",
    "addressPrefix": "10.0.0.0/16",
    "subnetName": "Subnet",
    "subnetPrefix": "10.0.0.0/24",
    "subnetRef": "[resourceId('Microsoft.Network/virtualNetworks/subnets', variables('virtualNetworkName'), variables('subnetName'))]",
    "vmName": "[parameters('virtualMachineName')]",
    "virtualNetworkName": "MyVNETt",
    "publicIPAddressName": "myPublicIPt",
    "networkSecurityGroupName": "default-NSGt",
    "UniqueStringBasedOnTimeStamp": "[uniqueString(deployment().name, parameters('_CurrentDateTimeInTicks'))]"
  },
  "resources": [
    {
      "apiVersion": "2020-08-01",
      "type": "Microsoft.Network/publicIPAddresses",
      "name": "[variables('publicIPAddressName')]",
      "location": "[parameters('vmLocation')]",
      "properties": {
        "publicIPAllocationMethod": "Dynamic",
        "dnsSettings": {
          "domainNameLabel": "[parameters('dnsNameForPublicIP')]"
        }
      }
    },
    {
      "comments": "Default Network Security Group for template",
      "type": "Microsoft.Network/networkSecurityGroups",
      "apiVersion": "2020-08-01",
      "name": "[variables('networkSecurityGroupName')]",
      "location": "[parameters('vmLocation')]",
      "properties": {
        "securityRules": [
          {
            "name": "default-allow-3389",
            "properties": {
              "priority": 1000,
              "access": "Allow",
              "direction": "Inbound",
              "destinationPortRange": "3389",
              "protocol": "Tcp",
              "sourceAddressPrefix": "*",
              "sourcePortRange": "*",
              "destinationAddressPrefix": "*"
            }
          }
        ]
      }
    },
    {
      "apiVersion": "2020-08-01",
      "type": "Microsoft.Network/virtualNetworks",
      "name": "[variables('virtualNetworkName')]",
      "location": "[parameters('vmLocation')]",
      "dependsOn": [
        "[resourceId('Microsoft.Network/networkSecurityGroups', variables('networkSecurityGroupName'))]"
      ],
      "properties": {
        "addressSpace": {
          "addressPrefixes": [
            "[variables('addressPrefix')]"
          ]
        },
        "subnets": [
          {
            "name": "[variables('subnetName')]",
            "properties": {
              "addressPrefix": "[variables('subnetPrefix')]",
              "networkSecurityGroup": {
                "id": "[resourceId('Microsoft.Network/networkSecurityGroups', variables('networkSecurityGroupName'))]"
              }
            }
          }
        ]
      }
    },
    {
      "apiVersion": "2020-08-01",
      "type": "Microsoft.Network/networkInterfaces",
      "name": "[variables('nicName')]",
      "location": "[parameters('vmLocation')]",
      "dependsOn": [
        "[variables('publicIPAddressName')]",
        "[variables('virtualNetworkName')]"
      ],
      "properties": {
        "ipConfigurations": [
          {
            "name": "ipconfig1",
            "properties": {
              "privateIPAllocationMethod": "Dynamic",
              "publicIPAddress": {
                "id": "[resourceId('Microsoft.Network/publicIPAddresses',variables('publicIPAddressName'))]"
              },
              "subnet": {
                "id": "[variables('subnetRef')]"
              }
            }
          }
        ]
      }
    },
    {
      "apiVersion": "2020-12-01",
      "type": "Microsoft.Compute/virtualMachines",
      "name": "[variables('vmName')]",
      "location": "[parameters('vmLocation')]",
      "dependsOn": [
        "[variables('nicName')]"
      ],
      "identity": {
             "type": "SystemAssigned"
      } ,
      "properties": {
        "hardwareProfile": {
          "vmSize": "[parameters('vmSize')]"
        },
        "osProfile": {
          "computerName": "[variables('vmName')]",
          "adminUsername": "[parameters('adminUsername')]",
          "adminPassword": "[parameters('adminPassword')]"
        },
        "storageProfile": {
          "imageReference": {
            "publisher": "MicrosoftWindowsServer",
            "offer": "WindowsServer",
            "sku": "[parameters('osVersion')]",
            "version": "latest"
          },
          "osDisk": {
            "createOption": "FromImage"
          }
        },
        "networkProfile": {
          "networkInterfaces": [
            {
              "id": "[resourceId('Microsoft.Network/networkInterfaces',variables('nicName'))]"
            }
          ]
        }
      }
    },
    {
      "type": "Microsoft.Automation/automationAccounts",
      "apiVersion": "2021-06-22",
      "name": "[parameters('automationAccount')]",
      "location": "[parameters('automationAccountLocation')]",
      "properties": {
        "sku": {
          "name": "Basic"
        }
      },
      "resources": [
        {
          "name": "[concat(parameters('workerGroupName'),'/',guid('AzureAutomationJobName', variables('UniqueStringBasedOnTimeStamp')))]",
          "type": "hybridRunbookWorkerGroups/hybridRunbookWorkers",
          "apiVersion": "2021-06-22",
          "dependsOn": [
            "[resourceId('Microsoft.Automation/automationAccounts', parameters('automationAccount'))]",
            "[resourceId('Microsoft.Compute/virtualMachines', variables('vmName'))]"
          ],
          "properties": {
            "vmResourceId": "[resourceId('Microsoft.Compute/virtualMachines', parameters('virtualMachineName'))]"
          }
        }
      ]
    },
    {
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "name": "[concat(parameters('virtualMachineName'),'/HybridWorkerExtension')]",
      "apiVersion": "2020-12-01",
      "location": "[parameters('vmLocation')]",
      "dependsOn": [
        "[resourceId('Microsoft.Automation/automationAccounts', parameters('automationAccount'))]",
        "[resourceId('Microsoft.Compute/virtualMachines', parameters('virtualMachineName'))]"
      ],
      "properties": {
        "publisher": "Microsoft.Azure.Automation.HybridWorker",
        "type": "HybridWorkerForWindows",
        "typeHandlerVersion": "0.1",
        "autoUpgradeMinorVersion": true,
        "settings": {
          "AutomationAccountURL": "[reference(resourceId('Microsoft.Automation/automationAccounts', parameters('automationAccount'))).AutomationHybridServiceUrl]"
        }
      }
    }
  ],
  "outputs": {
    "output1": {
      "type": "string",
      "value": "[reference(resourceId('Microsoft.Automation/automationAccounts', parameters('automationAccount'))).AutomationHybridServiceUrl]"
    }
  }
}

Sumber daya Azure berikut ini ditentukan dalam templat:

Meninjau parameter

Tinjau parameter yang digunakan dalam templat ini.

Properti Deskripsi
automationAccount Nama akun Azure Automation yang ada.
automationAccountLocation Wilayah akun Azure Automation yang ada.
workerGroupName Nama Grup Hybrid Worker yang ada.
virtualMachineName Nama VM yang akan dibuat. Nilai defaultnya adalah simple-vm.
adminUsername Nama pengguna admin VM.
adminPassword Kata sandi admin VM.
vmLocation Wilayah untuk VM baru. Nilai defaultnya adalah North Central US.
vmSize Ukuran untuk VM baru. Nilai defaultnya adalah Standard_DS1_v2.
osVersion OS untuk VM Windows yang baru. Nilai defaultnya adalah 2019-Datacenter.
dnsNameForPublicIP Nama DNS untuk IP Publik.

Menginstal ekstensi hybrid worker menggunakan REST API

Prasyarat

Anda akan memerlukan server dengan dukungan Azure VM atau Arc. Anda dapat mengikuti langkah-langkah di sini untuk membuat komputer yang terhubung dengan Arc.

Menginstal dan menggunakan ekstensi Hybrid Worker menggunakan REST API

Untuk menginstal dan menggunakan ekstensi Hybrid Worker menggunakan REST API, ikuti langkah-langkah berikut. Wilayah US Tengah Barat dipertimbangkan dalam contoh ini.

  1. Buat Grup Hybrid Worker dengan melakukan panggilan API ini.

    PUT https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}?api-version=2021-06-22

    Isi permintaan harus berisi informasi berikut:

    {
}

    Respons PUT mengonfirmasi apakah grup Hybrid worker dibuat atau tidak. Untuk mengonfirmasi ulang, Anda harus melakukan panggilan GET lain di grup Hybrid worker sebagai berikut:

    GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}?api-version=2021-06-22

  2. Koneksi VM ke Grup Hybrid Worker yang dibuat di atas dengan melakukan panggilan API di bawah ini. Sebelum melakukan panggilan, buat GUID baru untuk digunakan sebagai hybridRunbookWorkerId.

    PUT https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}/hybridRunbookWorkers/{hybridRunbookWorkerId}?api-version=2021-06-22

    Isi permintaan harus berisi informasi berikut:

    {
"properties": {"vmResourceId": "{VmResourceId}"}
}

    Respons panggilan PUT mengonfirmasi apakah hybrid worker dibuat atau tidak. Untuk mengonfirmasi ulang, Anda harus melakukan panggilan GET lain pada Hybrid worker sebagai berikut.

    GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}/hybridRunbookWorkers/{hybridRunbookWorkerId}?api-version=2021-06-22

  3. Ikuti langkah-langkah di sini untuk mengaktifkan Identitas terkelola yang ditetapkan sistem pada VM.

  4. Dapatkan detail akun otomatisasi menggunakan panggilan API ini.

    GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/HybridWorkerExtension?api-version=2021-06-22

    Panggilan API akan memberikan nilai dengan kunci: AutomationHybridServiceUrl. Gunakan URL di langkah berikutnya untuk mengaktifkan ekstensi pada VM.

  5. Instal Ekstensi Hybrid Worker di Azure VM dengan menggunakan panggilan API berikut.

    PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/extensions/HybridWorkerExtension?api-version=2021-11-01

    Isi permintaan harus berisi informasi berikut:

    {
"location": "<VMLocation>",
"properties": {
"publisher": "Microsoft.Azure.Automation.HybridWorker",
"type": "<HybridWorkerForWindows/HybridWorkerForLinux>",
"typeHandlerVersion": <version>,
"settings": {
  "AutomationAccountURL" = "<AutomationHybridServiceUrl>"
  }
 }
}

    Untuk VM ARC, gunakan panggilan API di bawah ini untuk mengaktifkan ekstensi:

    PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/extensions/{extensionName}?api-version=2021-05-20

    Isi permintaan harus berisi informasi berikut:

    {
"location": "<VMLocation>",
"properties": {
"publisher": "Microsoft.Azure.Automation.HybridWorker",
"type": "<HybridWorkerForWindows/HybridWorkerForLinux>",
"typeHandlerVersion": <version>,
"settings": {
  "AutomationAccountURL" = "<AutomationHybridServiceUrl>"
  }
 }
}

    Respons panggilan PUT akan mengonfirmasi apakah ekstensi berhasil diinstal atau tidak pada VM yang ditargetkan. Anda juga dapat membuka VM di portal Azure, dan memeriksa status ekstensi yang diinstal pada VM target di bawah tab Ekstensi.

Mengelola izin Peran untuk Grup Hybrid Worker dan Hybrid Worker

Anda dapat membuat peran Azure Automation kustom dan memberikan izin berikut ke Grup Hybrid Worker dan Hybrid Worker. Untuk mempelajari selengkapnya tentang cara membuat peran kustom Azure Automation, lihat Peran kustom Azure.

Tindakan Deskripsi
Microsoft.Automation/automationAccounts/hybridRunbookWorkerGroups/read Membaca Grup Hybrid Runbook Worker.
Microsoft.Automation/automationAccounts/hybridRunbookWorkerGroups/write Membuat Grup Hybrid Runbook Worker.
Microsoft.Automation/automationAccounts/hybridRunbookWorkerGroups/delete Menghapus Grup Hybrid Runbook Worker.
Microsoft.Automation/automationAccounts/hybridRunbookWorkerGroups/hybridRunbookWorkers/read Membaca Hybrid Runbook Worker.
Microsoft.Automation/automationAccounts/hybridRunbookWorkerGroups/hybridRunbookWorkers/write Membuat Hybrid Runbook Worker.
Microsoft.Automation/automationAccounts/hybridRunbookWorkerGroups/hybridRunbookWorkers/move/action Memindahkan Hybrid Runbook Worker dari satu Grup Pekerja ke Grup Pekerja lainnya.
Microsoft.Automation/automationAccounts/hybridRunbookWorkerGroups/hybridRunbookWorkers/delete Menghapus Hybrid Runbook Worker.

Langkah berikutnya