Migrasikan pusat konfigurasi Nacos yang dikelola sendiri ke MSE Nacos - Microservices Engine

Dibandingkan dengan Nacos yang dikelola sendiri, Microservices Engine (MSE) Nacos menyediakan fitur-fitur seperti enkripsi dan dekripsi konfigurasi serta pelacakan dorong. MSE Nacos merupakan layanan berkinerja tinggi, sangat tersedia, dan mudah digunakan yang secara signifikan mengurangi biaya O&M. Topik ini menjelaskan cara melakukan migrasi dari pusat konfigurasi Nacos open-source yang dikelola sendiri ke pusat konfigurasi MSE Nacos.

Prasyarat

Instans MSE Nacos telah dibuat. Untuk informasi selengkapnya, lihat Buat mesin Nacos.
Namespace yang diperlukan telah dibuat. Untuk informasi selengkapnya, lihat Buat namespace.
Catatan
Jika Anda menggunakan beberapa namespace di instans Nacos yang dikelola sendiri, buat namespace dengan ID dan nama yang sama di MSE Nacos untuk memastikan migrasi lancar.

Langkah 1: Migrasikan konfigurasi dari Nacos yang dikelola sendiri ke MSE Nacos

Metode 1: Gunakan fitur impor dan ekspor untuk migrasikan konfigurasi

Catatan

Impor dan ekspor konfigurasi untuk setiap namespace secara terpisah.

Ekspor konfigurasi dari konsol Nacos open-source yang dikelola sendiri.
1. Masuk ke konsol Nacos open-source yang dikelola sendiri.
2. Pada halaman Configuration List, pilih konfigurasi target, klik Export di bawah daftar, lalu klik Export dalam kotak dialog Export Configurations.
3. Simpan file konfigurasi yang diekspor.
Impor konfigurasi ke konsol MSE.
1. Masuk ke Konsol MSE.
2. Di panel navigasi sebelah kiri, pilih Microservices Registry > Instances. Klik nama instans tersebut.
3. Di panel navigasi sebelah kiri, pilih Configuration Management > Configurations.
4. Pada halaman Configuration List, pilih namespace target dan klik Import Configuration.
5. Dalam kotak dialog Import Configuration, konfigurasikan kebijakan impor. Jika konfigurasi dengan nama yang sama sudah ada, Anda dapat memilih untuk Stop Import, Skip, atau Overwrite. Unggah file konfigurasi yang telah Anda ekspor dari konsol Nacos yang dikelola sendiri, lalu klik Import.
Perbarui konfigurasi di kedua sisi.
Catatan
Untuk memastikan migrasi lancar, perbarui konfigurasi di kedua pusat konfigurasi—Nacos yang dikelola sendiri dan MSE Nacos—sebelum melakukan migrasi aplikasi Anda. Jika Anda menggunakan SDK untuk memperbarui konfigurasi, Anda harus menerapkan dual-write dalam program Anda. Jika Anda memperbarui konfigurasi melalui konsol, Anda harus melakukan pembaruan tersebut secara manual di kedua konsol.

Metode 2: Gunakan MSE Sync untuk mengonfigurasi tugas migrasi guna melakukan migrasi panas konfigurasi

Catatan

Untuk informasi selengkapnya tentang cara men-deploy alat sinkronisasi, lihat Solusi migrasi MSE Sync.

Setelah MSE Sync dideploy, masuk ke Konsol MSE. Di panel navigasi sebelah kiri, pilih Microservices Registry > Cloud Migration. Pada halaman Cloud Migration, klik Migrate Configurations.
Pada halaman Migrate Configurations, klik Next. Dalam langkah Create Configuration, atur Source Instance Type menjadi Nacos dan Sync Type menjadi Configuration Sync. Untuk Source Instance Node Address, masukkan alamat IP node dan port dari instans sumber. Untuk Target Instance, pilih instans tujuan. Lalu, klik Next. Dalam langkah Implement Migration, klik Download And Save Migration Configuration. Impor file konfigurasi yang diunduh ke MSE Sync untuk mengaktifkan sinkronisasi panas konfigurasi dari kluster sumber.

Penting

Sinkronisasi konfigurasi tidak mendukung konfigurasi rilis canary. Jika cakupan rilis canary dari kluster sumber atau tujuan mencakup alat sinkronisasi, alat tersebut akan menyinkronkan konfigurasi canary ke kluster pasangan sebagai konfigurasi biasa.
Jangan memodifikasi konfigurasi di kluster sumber dan tujuan secara bersamaan.

Langkah 2: Ganti parameter bisnis aplikasi

Ikuti langkah-langkah berikut sesuai jenis aplikasi Anda untuk mengganti parameter bisnisnya:

Migrasikan aplikasi Spring Cloud Alibaba

Identifikasi apakah aplikasi Anda merupakan aplikasi Spring Cloud Alibaba.
Jika dependensi berikut ada dalam file pom.xml, maka aplikasi Anda adalah aplikasi Spring Cloud Alibaba.
```
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
```
Jika aplikasi Anda adalah aplikasi Spring Cloud Alibaba, modifikasi file konfigurasi bootstrap.properties-nya.
Ganti {MSE public/private endpoint} dengan titik akhir instans MSE Nacos tujuan. Titik akhir tersebut dapat ditemukan pada halaman informasi dasar instans.
```
spring.cloud.nacos.config.server-addr=${MSE public/private endpoint}
```
Pada konfigurasi berikut, ganti namespace dengan namespace yang sesuai di MSE. Jika ID namespace-nya sama, tidak perlu dilakukan modifikasi. Namespace default di MSE kosong, sehingga Anda dapat membiarkan parameter ini kosong. Jika Anda menggunakan namespace kustom, ID-nya dapat ditemukan pada halaman Namespaces instans Nacos.

Catatan

Jika Anda menggunakan alamat IP publik untuk penerapan, tambahkan alamat IP klien ke daftar putih untuk memastikan konektivitas. Untuk informasi selengkapnya, lihat Konfigurasi daftar putih.
Jika daftar putih kosong, semua alamat IP dapat mengakses aplikasi.

Migrasikan aplikasi Java

Identifikasi apakah aplikasi Anda menggunakan Nacos SDK for Java.
Jika dependensi berikut ada dalam file pom.xml, maka aplikasi Anda menggunakan Nacos SDK for Java.
```
<dependency>
  <groupId>com.alibaba.nacos</groupId>
  <artifactId>nacos-client</artifactId>
</dependency>
```
Jika aplikasi Anda menggunakan Nacos SDK for Java, modifikasi kode berikut. Ganti ${MSE endpoint} dengan titik akhir MSE dan ${namespaceId} dengan ID namespace MSE. Jika Anda menggunakan namespace default, Anda dapat membiarkan ID namespace kosong. Jika ID namespace-nya sama seperti di sumber, tidak perlu dilakukan modifikasi. Setelah memodifikasi kode, redeploy aplikasi.
```
properties.put("serverAddr", "${MSE endpoint}");
properties.put("namespace", "${namespaceId}");
```

Migrasikan aplikasi nacos-spring-boot

Jika aplikasi Anda adalah aplikasi nacos-spring-boot, modifikasi file konfigurasi application.properties-nya.

Ganti ${MSE endpoint} dengan titik akhir MSE.

nacos.config.server-addr=${MSE endpoint}

Pada konfigurasi berikut, ganti namespace dengan namespace di MSE:

nacos.config.namespace=${MSE namespace ID}

Migrasikan aplikasi Go

Catatan

Sebelum memanggil API, konfigurasikan variabel lingkungan untuk membaca kredensial akses. Nama variabel lingkungan untuk ID AccessKey dan Rahasia AccessKey Microservices Engine adalah `MSE_AK` dan `MSE_SK`.

Jika Anda menggunakan Nacos SDK for Go, ganti ${serverAddr} dengan titik akhir MSE.

sc := []constant.ServerConfig{
    {
    IpAddr: "${serverAddr}",
    Port:   8848,
    },
}

Catatan

Untuk contoh demo aplikasi Go, lihat nacos-sdk-go.

Migrasikan aplikasi Python

Jika Anda menggunakan Nacos SDK for Python, ganti ${server_address} dan ${namespace_id} dengan titik akhir MSE dan ID namespace.

SERVER_ADDRESSES = "${server_address}"
NAMESPACE = "${namespace_id}"
client = nacos.NacosClient(SERVER_ADDRESSES, namespace=NAMESPACE)

Migrasikan aplikasi Node.js

Jika Anda menggunakan Nacos SDK for Node.js, ganti ${server_address} dan ${namespace_id} dengan titik akhir MSE dan ID namespace.

const configClient = new NacosConfigClient({
  serverAddr: '${server_address}',
  namespace: '${namespace_id}',
  accessKey: 'MSE_AK',
  secretKey: 'MSE_SK',
  requestTimeout: 6000,
});

Migrasikan aplikasi C#

Ganti ${server_address} dan ${namespace_id} dengan titik akhir MSE dan ID namespace.

{
  "NacosConfig": {
    "Listeners": [
      {
        "Optional": false,
        "DataId": "common",
        "Group": "DEFAULT_GROUP"
      },
      {
        "Optional": false,
        "DataId": "demo",
        "Group": "DEFAULT_GROUP"
      }
    ],
    "Namespace": "namespace_id", 
    "ServerAddresses": [ "http://${server_address}:8848/" ],
    "UserName": "test2",
    "Password": "123456",
    "AccessKey": "MSE_AK",
    "SecretKey": "MSE_SK",
    "EndPoint": "acm.aliyun.com",
    "ConfigFilterAssemblies": ["YouPrefix.AssemblyName"],
    "ConfigFilterExtInfo": "some ext information"
  }
}

Migrasikan aplikasi C++

Jika Anda menggunakan Nacos SDK for C++, ganti ${server_address} dan ${namespace_id} dengan titik akhir MSE dan ID namespace.

Properties props;
props[PropertyKeyConst::SERVER_ADDR] = "${server_address}:8848";
props[PropertyKeyConst::NAMESPACE] = "{namespaceId}";

Langkah 3: Lakukan pemeriksaan mandiri dan nonaktifkan instans yang dikelola sendiri

Setelah Anda sepenuhnya memigrasikan aplikasi ke MSE Nacos dan memverifikasi bahwa layanan berjalan sebagaimana mestinya, Anda dapat menghentikan dual-write konfigurasi. Pantau lalu lintas pada instans yang dikelola sendiri. Jika tidak ada koneksi aktif atau catatan kueri dorongan konfigurasi, Anda dapat menonaktifkan instans yang dikelola sendiri untuk menyelesaikan migrasi.