Gunakan ACK SDK untuk Java untuk buat ACK managed cluster - Container Service for Kubernetes

Topik ini menjelaskan cara menggunakan SDK Container Service for Kubernetes (ACK) untuk memanggil API ACK guna membuat kluster ACK yang dikelola.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

Akun Alibaba Cloud atau RAM user — Identitas pemanggil harus memiliki akses API. Akun Alibaba Cloud memiliki akses penuh ke semua operasi API; gunakan RAM user untuk operasi dan pemeliharaan (O&M) rutin. Untuk detailnya, lihat Identitas.
Izin AliyunCSFullAccess — Berikan kebijakan ini kepada RAM user yang memanggil API. Untuk akses read-only, berikan AliyunCSReadOnlyAccess sebagai gantinya.
Pasangan Kunci Akses (AccessKey pair) — Buat di tab Authentication pada halaman detail RAM user. Untuk petunjuknya, lihat Buat pasangan Kunci Akses.
Java dan IntelliJ IDEA — Diperlukan untuk menjalankan proyek demo SDK yang diunduh dari OpenAPI Explorer.
Maven — Proyek demo menggunakan Maven untuk mengelola dependensi.

Langkah 1: Baca referensi API

Sebelum memanggil API, baca Buat kluster ACK yang dikelola untuk memahami parameter wajib dan opsional. Untuk daftar lengkap operasi API ACK, lihat Daftar operasi berdasarkan fungsi.

Langkah 2: Siapkan RAM user

Lewati langkah ini jika Anda sudah memiliki RAM user dengan izin AliyunCSFullAccess dan pasangan Kunci Akses.

Buat RAM user. Login ke Konsol RAM menggunakan akun Alibaba Cloud Anda.
Di panel navigasi kiri, pilih Identities > Users.
Pada halaman Users, klik Create User.
Pada halaman Create User, konfigurasikan Logon Name dan Display Name, lalu atur Access Mode menjadi Console Access.
Klik OK. Catat username dan password — Anda akan menggunakannya untuk login ke konsol OpenAPI Explorer.
Berikan izin AliyunCSFullAccess kepada RAM user tersebut. Untuk petunjuknya, lihat Berikan izin kepada RAM user.
Catatan
AliyunCSFullAccess memberikan izin penuh atas Container Service for Kubernetes. AliyunCSReadOnlyAccess memberikan akses read-only. Untuk kebijakan izin kustom, lihat Otorisasi RAM.
Pada halaman detail pengguna, klik tab Authentication, lalu klik Create AccessKey untuk menghasilkan pasangan Kunci Akses.

Langkah 3: Panggil API

Contoh ini menggunakan SDK ACK untuk Java guna memanggil operasi API CreateCluster dan membuat kluster ACK Pro. SDK untuk bahasa lain bekerja dengan cara yang sama. Untuk daftar lengkap SDK yang didukung, lihat Container Service for Kubernetes SDK. Untuk metode pemanggilan alternatif, lihat Metode pemanggilan.

Konfigurasikan variabel lingkungan

Simpan kredensial Kunci Akses Anda sebagai variabel lingkungan, bukan dengan hardcoding di kode sumber. Untuk petunjuk penyiapan, lihat Konfigurasikan variabel lingkungan di Linux, macOS, dan Windows.

Unduh demo SDK

Buka API Explorer CreateCluster.CreateCluster

Pada tab Parameters, masukkan nilai contoh berikut lalu klik Initiate Call:

Parameter	Nilai contoh
`name`	`test`
`region_id`	`cn-beijing`
`cluster_type`	`ManagedKubernetes`
`cluster_spec`	`ack.pro.small`
`cluster_version`	`1.30.1-aliyun.1`
`vpcid`	`vpc-2zedl8cyb7tnkaux1****`
`container_cidr`	`10.0.0.0/8`
`service_cidr`	`172.21.0.0/20`
`vswitch_ids`	`vsw-2ze7hfp0ah8rk1nz9****`

Pada tab SDK Sample Code, pilih version 2.0, pilih Java sebagai bahasa, lalu klik Download Project. Ekstrak paket yang diunduh ke mesin lokal Anda.
Catatan
Gunakan SDK versi 2.0. Untuk perbandingan antara versi 1.0 dan 2.0, lihat Alibaba Cloud SDK V1.0 dan V2.0.

Jalankan demo SDK

Buka IntelliJ IDEA, pilih File > Open, lalu pilih folder proyek yang telah diekstrak. Tunggu hingga Maven selesai menginstal dependensi.
Klik ganda Sample untuk membuka kelas entri. Pastikan tidak ada error yang ditampilkan, lalu jalankan kode contoh tersebut.
Di output konsol di bagian bawah IDE, cari statusCode. Tanggapan yang berisi "statusCode":202 berarti pemanggilan API berhasil dan ACK sedang membuat kluster.
Untuk memastikan kluster sedang dibuat, login ke Konsol ACK dan buka halaman Clusters untuk melihat kluster yang baru dibuat.