Membuat dan memodifikasi Network Fabric Controller menggunakan Azure CLI
Artikel ini menjelaskan cara membuat Network Fabric Controller (NFC) dengan menggunakan Azure Command Line Interface (AzureCLI). Dokumen ini juga menunjukkan kepada Anda cara memeriksa status, atau menghapus Network Fabric Controller.
Prasyarat
Anda harus menerapkan semua prasyarat sebelum membuat NFC.
Nama, seperti untuk sumber daya, tidak boleh berisi karakter garis bawah (_).
Memvalidasi sirkuit ExpressRoute
Validasi sirkuit ExpressRoute untuk konektivitas yang benar (CircuitID)(AuthID); Provisi NFC akan gagal jika konektivitas salah.
Membuat Network Fabric Controller
Anda harus membuat grup sumber daya sebelum membuat NFC.
Catatan: Anda harus membuat Grup Sumber Daya terpisah untuk setiap NFC.
Anda membuat grup sumber daya dengan menjalankan perintah berikut:
az group create -n NFCResourceGroupName -l "<Location>"
Atribut untuk pembuatan NFC
| Parameter | Deskripsi | nilai | Contoh | Wajib | Tipe |
|---|---|---|---|---|---|
| Grup Sumber Daya | Grup sumber daya adalah kontainer yang menampung sumber daya terkait untuk solusi Azure. | NFCResourceGroupName | XYZNFCResourceGroupName | Benar | String |
| Lokasi | Wilayah Azure wajib untuk memprovisikan penyebaran Anda. | eastus, westus3, southcentralus, eastus2euap | eastus | Benar | String |
| Nama Sumber Daya | Nama sumber daya akan menjadi nama Pengontrol Fabric Jaringan | nfcname | XYZnfcname | Benar | String |
| ipv4-address-space | Ruang Alamat Pengontrol Fabric Jaringan IPv4, blok subnet default adalah 10.0.0.0/19, dan juga tidak boleh tumpang tindih dengan IP ExpressRoute mana pun | 10.0.0.0/19 | 10.0.0.0/19 | Tidak Diperlukan | String |
| ipv6-address-space | Ruang Alamat Pengontrol Fabric Jaringan IPv6, parameter ini default ke FC00::/59, dengan rentang yang diizinkan /59 | "FC00::/59" | "FC00::/59" | Tidak Diperlukan | String |
| Sirkuit Rute Ekspres | Sirkuit ExpressRoute adalah tautan 10G khusus yang menghubungkan Azure dan lokal. Anda perlu mengetahui ID Sirkuit ExpressRoute dan kunci Auth agar NFC berhasil disediakan. Ada dua Sirkuit Rute Ekspres, satu untuk layanan Infrastruktur dan satu lagi untuk layanan Beban Kerja (Penyewa) | --infra-er-connections '[{"expressRouteCircuitId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx", "expressRouteAuthorizationKey": "xxxxxxx-xxx-xxxx-xxx"}]' --workload-er-connections '[{"expressRouteCircuitId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx", "expressRouteAuthorizationKey": "xxxxx-xxx-xxxx-xxx"}]' |
subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01", "expressRouteAuthorizationKey": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx"}] | Benar | string |
| Grup Sumber Daya Terkelola | Properti konfigurasi Grup Sumber Daya Terkelola. | NFCManagedResourceGroupName | XYZNFCManagedResourceGroupName | Benar | String |
Berikut adalah contoh bagaimana Anda dapat membuat NFC menggunakan Azure CLI. Untuk informasi selengkapnya, lihat bagian atribut.
az networkfabric controller create \
--resource-group "NFCResourceGroupName" \
--location "<Location>" \
--resource-name "nfcname" \
--ipv4-address-space "10.0.0.0/19" \
--ipv6-address-space "FC00::/59" \
--infra-er-connections '[{"expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01", "expressRouteAuthorizationKey": "<auth-key>"}]'
--workload-er-connections '[{"expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01"", "expressRouteAuthorizationKey": "<auth-key>"}]' \
--debug --no-wait
Catatan: Pembuatan NFC membutuhkan waktu antara 30-45 menit.
show Gunakan perintah untuk memantau kemajuan pembuatan NFC.
Anda akan melihat berbagai status provisi seperti, Diterima, diperbarui, dan Berhasil/Gagal.
Hapus dan buat ulang NFC jika pembuatan gagal (Failed).
Output yang diharapkan hanya menunjukkan berjalan segera setelah Anda menjalankan melalui AzureCLI
Output yang diharapkan:
{
"id": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/NFCResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkFabricControllers/nfcname",
"infrastructureExpressRouteConnections": [
{
"expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-02"
}
],
"infrastructureServices": {
"ipv4AddressSpaces": [
"10.0.0.0/21"
],
"ipv6AddressSpaces": []
},
"ipv4AddressSpace": "10.0.0.0/19",
"ipv6AddressSpace": "FC00::/59",
"isWorkloadManagementNetworkEnabled": "True",
"location": "<Location>",
"managedResourceGroupConfiguration": {},
"name": "NFCName",
"provisioningState": "Succeeded",
"resourceGroup": "NFCResourceGroupName",
"systemData": {
"createdAt": "2023XX-XXT18:59:41.7805324Z",
"createdBy": "email@address.com",
"createdByType": "User",
"lastModifiedAt": "2023-XX-XXT09:50:27.4598499Z",
"lastModifiedBy": "d1bd24c7-b27f-477e-86dd-939e107873d7",
"lastModifiedByType": "Application"
},
"type": "microsoft.managednetworkfabric/networkfabriccontrollers",
"workloadExpressRouteConnections": [
{
"expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx//resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-03"
}
],
"workloadManagementNetwork": true,
"workloadServices": {
"ipv4AddressSpaces": [
"10.0.28.0/22"
],
"ipv6AddressSpaces": []
}
}
Dapatkan Network Fabric Controller
az networkfabric controller show --resource-group "NFCResourceGroupName" --resource-name "nfcname"
Output yang diharapkan:
{
"id": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/NFCResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkFabricControllers/nfcname",
"infrastructureExpressRouteConnections": [
{
"expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-02"
}
],
"infrastructureServices": {
"ipv4AddressSpaces": [
"10.0.0.0/21"
],
"ipv6AddressSpaces": []
},
"ipv4AddressSpace": "10.0.0.0/19",
"ipv6AddressSpace": "FC00::/59",
"isWorkloadManagementNetworkEnabled": "True",
"location": "<Location>",
"managedResourceGroupConfiguration": {},
"name": "NFCName",
"provisioningState": "Succeeded",
"resourceGroup": "NFCResourceGroupName",
"systemData": {
"createdAt": "2023XX-XXT18:59:41.7805324Z",
"createdBy": "email@address.com",
"createdByType": "User",
"lastModifiedAt": "2023-XX-XXT09:50:27.4598499Z",
"lastModifiedBy": "d1bd24c7-b27f-477e-86dd-939e107873d7",
"lastModifiedByType": "Application"
},
"type": "microsoft.managednetworkfabric/networkfabriccontrollers",
"workloadExpressRouteConnections": [
{
"expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx//resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-03"
}
],
"workloadManagementNetwork": true,
"workloadServices": {
"ipv4AddressSpaces": [
"10.0.28.0/22"
],
"ipv6AddressSpaces": []
}
}
Memperbarui Pengontrol Fabric Jaringan
Fitur PATCH di Network Fabric Controller memberi pengguna kemampuan untuk menambahkan atau mengganti sirkuit Rute Ekspres tambahan dengan mudah. Fungsionalitas ini sangat berguna selama periode kegagalan atau potensi peristiwa migrasi. Dalam kasus seperti itu, Operator Jaringan memiliki fleksibilitas untuk memodifikasi Network Fabric Controller aktif dengan menambahkan atau menghapus Rute dan Kunci Ekspres, sekaligus memastikan operasi tetap tidak terpengaruh.
Catatan
Saat memulai perintah pembaruan, sangat penting untuk menyediakan semua parameter yang disediakan selama proses pembuatan. Ini karena perintah pembaruan akan menimpa konten yang ada, mengharuskan penyertaan semua parameter yang relevan untuk memastikan modifikasi yang komprehensif dan akurat.
az networkfabric controller update \
--resource-group "NFCResourceGroupName" \
--location "<Location>" \
--resource-name "nfcname" \
--ipv4-address-space "10.0.0.0/19" \
--infra-er-connections '[{"expressRouteCircuitId":"/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01", "expressRouteAuthorizationKey": "<auth-key>"}]'
--workload-er-connections '[{"expressRouteCircuitId":"/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01"", "expressRouteAuthorizationKey": "<auth-key>"}]'
Catatan
Jalankan az networkfabric controller show untuk mengambil informasi tentang pengontrol fabric jaringan.
Perbarui Pengontrol Fabrc Jaringan dengan beberapa ExpressRoute sirkuit.
az networkfabric controller update \
--resource-group "NFCResourceGroupName" \
--location "eastus" \
--resource-name "nfcname" \
--ipv4-address-space "10.0.0.0/19" \
--infra-er-connections "[{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01',expressRouteAuthorizationKey:'<auth-key>'},{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-02',expressRouteAuthorizationKey:'<auth-key>'}]"
--workload-er-connections "[{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-03',expressRouteAuthorizationKey:'<auth-key>'},{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-04',expressRouteAuthorizationKey:'<auth-key>'}]"
| Perintah | Keterangan |
|---|---|
az networkfabric controller update |
Perintah untuk memperbarui pengontrol fabric jaringan yang ada di Azure |
| Parameter | Keterangan | Contoh Nilai |
|---|---|---|
--resource-group |
Menentukan grup sumber daya tempat pengontrol fabric jaringan berada. | "NFCResourceGroupName" |
--location |
Menentukan wilayah Azure tempat pengontrol fabric jaringan disebarkan. | "eastus" |
--resource-name |
Nama sumber daya pengontrol fabric jaringan yang ingin Anda perbarui. | "nfcname" |
--ipv4-address-space |
Menentukan ruang alamat IPv4 untuk pengontrol fabric jaringan. | "10.0.0.0/19" |
--infra-er-connections |
Menentukan koneksi ExpressRoute infrastruktur dalam format array JSON. | "[{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-11',expressRouteAuthorizationKey:'<auth-key>'},{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-13',expressRouteAuthorizationKey:'<auth-key>'}]" |
--workload-er-connections |
Menentukan koneksi ExpressRoute beban kerja dalam format array JSON. | "[{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-11',expressRouteAuthorizationKey:'<auth-key>'},{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-12',expressRouteAuthorizationKey:'<auth-key>'}]" |
Catatan
Ganti tempat penampung seperti "NFCResourceGroupName", "nfcname", dan "<auth-key>" dengan nilai aktual yang relevan dengan penyiapan Anda.
Hapus Pengontrol Fabric Jaringan
Anda harus menghapus NFC hanya setelah menghapus semua fabric jaringan terkait.
az networkfabric controller delete --resource-group "NFCResourceGroupName" --resource-name "nfcname"
Output yang diharapkan:
"name": "nfcname",
"networkFabricIds": [],
"operationalState": null,
"provisioningState": "succeeded",
"resourceGroup": "NFCResourceGroupName",
"systemData": {
"createdAt": "2022-10-31T10:47:08.072025+00:00",
Catatan
Dibutuhkan 30 menit untuk menghapus NFC. Di portal Azure, verifikasi bahwa sumber daya yang dihosting telah dihapus.
Langkah berikutnya
Setelah Anda berhasil membuat NFC, langkah selanjutnya adalah membuat manajer kluster.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk