Untuk menyediakan dan mengelola cluster di software Google Distributed Cloud khusus untuk VMware, Anda memerlukan workstation admin. Mesin ini menyediakan alat antarmuka command line (CLI)
dan file konfigurasi yang Anda gunakan untuk men-deploy cluster selama
penginstalan dan untuk berinteraksi dengannya setelahnya. Anda dapat membuat workstation admin sebagai VM vSphere menggunakan gkeadm, atau Anda dapat menyiapkan workstation yang dikelola pengguna di komputer pilihan Anda. Dokumen ini memberikan petunjuk lengkap untuk kedua pendekatan tersebut. Untuk petunjuk yang lebih singkat,
lihat
Membuat workstation admin
dalam panduan Membuat cluster dasar.
Memilih cara membuat workstation admin
Ada dua cara untuk membuat workstation admin:
- Gunakan
gkeadmuntuk membuat VM workstation admin di lingkungan vSphere Anda. - Buat workstation admin yang dikelola pengguna di komputer pilihan Anda.
Kedua pendekatan ini memiliki kelebihan dan kekurangan.
Saat Anda menggunakan gkeadm untuk membuat workstation admin, gkeadm akan melakukan
hal berikut, yang menyederhanakan penyiapan:
- Membuat VM workstation admin.
- Menggunakan template VM yang memiliki semua software yang Anda perlukan untuk membuat dan
mengelola cluster menggunakan alat command line
gkectl. - Membuat satu akun pengguna yang Anda atau administrator lain gunakan untuk login ke workstation admin.
- Menyediakan perintah SSH untuk login ke workstation admin dengan akun pengguna yang disediakan.
Workstation admin yang dibuat gkeadm hanya dapat mengelola satu cluster admin. Jika
Anda berencana membuat beberapa cluster admin, Anda harus membuat workstation
admin untuk setiap cluster admin.
Workstation admin yang dibuat gkeadm terkait dengan siklus proses cluster. Saat Anda
mengupgrade cluster admin atau salah satu cluster pengguna yang dikelola oleh cluster
admin, Anda harus mengupgrade workstation admin terlebih dahulu.
Saat menyiapkan workstation admin sendiri, Anda harus menginstal salah satu
sistem operasi yang diperlukan dan semua software yang diperlukan. Hal ini membuat penyiapan awal
memakan lebih banyak waktu karena membuat VM dari template lebih cepat daripada
menginstal software yang diperlukan di komputer. Namun, setelah workstation disiapkan, workstation tersebut memiliki keunggulan berikut dibandingkan workstation admin yang dibuat gkeadm:
- Anda dapat mengonfigurasi workstation yang dikelola pengguna untuk membuat dan mengelola lebih dari satu cluster admin.
- Anda tidak perlu mengupgrade workstation admin yang dikelola pengguna saat mengupgrade cluster.
- Anda dapat menggunakan alat CI/CD standar untuk mengotomatiskan pengelolaan siklus proses cluster.
- Anda dapat menggunakan metode autentikasi standar seperti Active Directory untuk mengontrol akses ke workstation admin.
- Anda dapat menggunakan sistem otorisasi standar untuk mengontrol apa yang dapat diakses pengguna di workstation admin dan untuk mengaudit tindakan mereka.
- Anda dapat memilih software yang ingin digunakan untuk membuat snapshot atau cadangan workstation admin.
Membuat workstation admin
Ikuti langkah-langkah di tab untuk pendekatan yang Anda pilih: gunakan gkeadm untuk membuat VM workstation admin di vSphere, atau siapkan workstation admin yang dikelola pengguna di komputer pilihan Anda.
gkeadm
Sebelum memulai
Ketahui alamat server vCenter Anda.
Ketahui jalur sertifikat CA Anda.
Buat satu atau beberapa project Google Cloud seperti yang dijelaskan dalam Menggunakan beberapa Google Cloud project.
Merencanakan akun layanan Anda
Saat menggunakan gkeadm untuk membuat workstation admin, Anda memiliki opsi untuk
membiarkan gkeadm membuat beberapa akun layanan dan kunci untuk Anda. Dalam hal ini, gkeadm juga memberikan peran Identity and Access Management yang sesuai ke akun layanan.
Sebagai alternatif, Anda dapat membuat akun layanan dan kunci secara manual. Dalam hal ini, Anda harus memberikan peran IAM secara manual ke akun layanan Anda.
Membuat akun layanan secara manual memberi Anda lebih banyak fleksibilitas daripada meminta
gkeadm membuatnya untuk Anda:
Semua akun layanan yang dibuat secara otomatis memiliki project indukGoogle Cloud yang sama dengan akun layanan akses komponen Anda. Saat membuat akun layanan secara manual, Anda dapat memilih project Google Cloud induk.
Semua akun layanan yang dibuat secara otomatis diberi peran IAM pada project Google Cloud induk dari akun layanan akses komponen Anda. Hal ini tidak masalah jika itu adalah satu-satunya project Google Cloud yang terkait dengan cluster Anda. Namun, jika Anda ingin mengaitkan cluster dengan beberapa Google Cloud project, Anda memerlukan fleksibilitas untuk memberikan peran ke akun layanan pada Google Cloud project pilihan Anda.
Jika Anda memutuskan untuk membuat akun layanan sendiri, ikuti petunjuk di Akun dan kunci layanan.
Terlepas dari apakah Anda memiliki gkeadm yang membuat akun layanan
untuk Anda secara otomatis, ada satu akun layanan yang harus Anda buat
secara manual: akun layanan akses komponen Anda. Untuk mengetahui petunjuk tentang cara membuat
akun layanan akses komponen dan memberinya peran
IAM yang sesuai, lihat
Akun layanan akses komponen.
Ada satu akun layanan lain yang mungkin perlu Anda buat secara manual: akun layanan logging audit Anda. Jika Anda ingin menggunakan klien GKE On-Prem API untuk mengelola cluster pengguna, Anda harus mengaktifkan logging audit di cluster admin.
Membuat template untuk file konfigurasi Anda
Download gkeadm ke direktori Anda saat ini.
Membuat template:
./gkeadm create config
Perintah sebelumnya membuat file berikut di direktori Anda saat ini:
credential.yamladmin-ws-config.yaml
Mengisi credential.yaml
Di credential.yaml, isi nama pengguna dan sandi vCenter Anda. Contoh:
kind: CredentialFile items: - name: vCenter username: "my-account-name" password: "AadmpqGPqq!a"
Mengisi admin-ws-config.yaml
Beberapa kolom di admin-ws-config.yaml sudah diisi dengan nilai default atau nilai yang dihasilkan. Anda dapat mempertahankan nilai yang diisi atau membuat perubahan sesuai keinginan.
Kolom yang harus Anda isi
Isi kolom wajib diisi berikut. Untuk mengetahui informasi tentang cara mengisi kolom, lihat File konfigurasi workstation admin.
gcp: componentAccessServiceAccountKeyPath: "Fill in" vCenter: credentials: address: "Fill in" datacenter: "Fill in" datastore: "Fill in" cluster: "Fill in" network: "Fill in" resourcePool: "Fill in" caCertPath: "Fill in"
Jika Anda ingin membuat workstation admin di dalam folder VM vSphere, isi kolom vCenter.folder:
vCenter: folder: "Fill in"
Jika workstation admin Anda akan berada di belakang server proxy, isi kolom proxyURL:
adminWorkstation: proxyURL: "Fill in"
Jika Anda ingin workstation admin mendapatkan alamat IP-nya dari server DHCP,
tetapkan ipAllocationMode ke "dhcp", dan hapus bagian hostconfig:
adminWorkstation: network: ipAllocationMode: "dhcp"
Jika Anda ingin menentukan alamat IP statis untuk workstation admin, tetapkan
ipAllocationMode ke "static", dan isi
bagian
hostconfig:
adminWorkstation:
network:
ipAllocationMode: "static"
hostconfig:
ip: "Fill in"
gateway: "Fill in"
netmask: "Fill in"
dns:
- "Fill in"
Login
Akun Google yang ditetapkan sebagai
properti account SDK Anda
disebut akun SDK Anda. Alat command line gkeadm menggunakan akun SDK Anda untuk mendownload OVA workstation admin dan mengaktifkan layanan di projectGoogle Cloud Anda.
Jika Anda memilih agar gkeadm membuat akun layanan secara otomatis untuk Anda,
gkeadm juga akan menggunakan akun SDK Anda untuk membuat akun layanan dan kunci,
serta memberikan peran ke akun layanan.
Jadi, penting bagi Anda untuk menetapkan properti account SDK sebelum menjalankan
gkeadm untuk membuat workstation admin.
Login dengan Akun Google apa pun. Tindakan ini akan menetapkan properti
accountSDK Anda:gcloud auth login
Pastikan properti
accountSDK Anda ditetapkan dengan benar:gcloud config list
Output akan menampilkan nilai properti
accountSDK Anda. Contoh:[core] account = my-name@google.com disable_usage_reporting = False Your active configuration is: [default]
Memberikan peran ke akun SDK Anda
Akun SDK Anda harus memiliki
peran IAM
berikut di project Google Cloud induk akun layanan akses komponen Anda.
Hal ini dilakukan agar gkeadm dapat mengaktifkan layanan di project Google Cloud .
serviceUsage.serviceUsageAdmin
Jika Anda memilih agar gkeadm membuat akun layanan secara otomatis untuk Anda,
akun SDK Anda juga harus memiliki peran berikut pada project induk
akun layanan akses komponen Anda. Hal ini dilakukan agar gkeadm dapat
membuat akun dan kunci layanan.
resourcemanager.projectIamAdminiam.serviceAccountCreatoriam.serviceAccountKeyAdmin
Untuk memberikan peran pada project Google Cloud , Anda harus memiliki izin tertentu pada project Google Cloud . Untuk mengetahui detailnya, lihat Memberikan, mengubah, dan mencabut akses ke resource.
Jika memiliki izin yang diperlukan, Anda dapat memberikan peran sendiri. Jika tidak, orang lain di organisasi Anda harus memberikan peran untuk Anda.
Untuk memberikan peran yang diperlukan ke akun SDK Anda:
Linux and macOS
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="user:ACCOUNT" \ --role="roles/serviceusage.serviceUsageAdmin"
Windows
gcloud projects add-iam-policy-binding PROJECT_ID ^ --member="user:ACCOUNT" ^ --role="roles/serviceusage.serviceUsageAdmin"
Ganti kode berikut:
PROJECT_ID: ID project induk Google Cloud dari akun layanan akses komponen AndaACCOUNT: akun SDK Anda
Untuk memberikan peran tambahan jika Anda ingin gkeadm membuat akun layanan secara otomatis:
Linux and macOS
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="user:ACCOUNT" \ --role="roles/resourcemanager.projectIamAdmin" gcloud projects add-iam-policy-binding PROJECT_ID \ --member="user:ACCOUNT" \ --role="roles/iam.serviceAccountCreator" gcloud projects add-iam-policy-binding PROJECT_ID \ --member="user:ACCOUNT" \ --role="roles/iam.serviceAccountKeyAdmin"
Windows
gcloud projects add-iam-policy-binding PROJECT_ID ^ --member="user:ACCOUNT" ^ --role="roles/resourcemanager.projectIamAdmin" gcloud projects add-iam-policy-binding PROJECT_ID ^ --member="user:ACCOUNT" ^ --role="roles/iam.serviceAccountCreator" gcloud projects add-iam-policy-binding PROJECT_ID ^ --member="user:ACCOUNT" ^ --role="roles/iam.serviceAccountKeyAdmin"
Ganti kode berikut:
PROJECT_ID: ID project induk akun layanan akses komponen AndaACCOUNT: akun SDK Anda
Membuat workstation admin Anda
Masukkan perintah ini untuk membuat workstation admin Anda. Jika Anda ingin
gkeadm membuat akun layanan
connect-register
dan
logging-monitoring
untuk Anda, sertakan
flag --auto-create-service-accounts. Jika Anda ingin membuat akun layanan tersebut secara manual, hapus flag.
./gkeadm create admin-workstation [--auto-create-service-accounts]
Output tersebut memberikan informasi mendetail tentang pembuatan workstation admin Anda:
... Getting ... service account... ... ******************************************************************** Admin workstation is ready to use. Admin workstation information saved to /usr/local/google/home/me/my-admin-workstation This file is required for future upgrades SSH into the admin workstation with the following command: ssh -i /usr/local/google/home/me/.ssh/gke-admin-workstation ubuntu@172.16.5.1 ********************************************************************
Mendapatkan koneksi SSH ke workstation admin Anda
Di dekat akhir output sebelumnya, ada perintah yang dapat Anda gunakan untuk mendapatkan koneksi SSH ke workstation admin. Masukkan perintah tersebut sekarang. Contoh:
ssh -i /usr/local/google/home/me/.ssh/gke-admin-workstation ubuntu@172.16.5.1
Cantumkan daftar file di workstation admin Anda:
ls -1
Dalam output, Anda dapat melihat dua file konfigurasi cluster, file sertifikat CA, dan file kunci JSON untuk akun layanan akses komponen. Jika gkeadm membuat akun layanan untuk Anda, Anda juga dapat
melihat file kunci JSON untuk akun layanan tersebut. Contoh:
admin-cluster.yaml user-cluster.yaml vcenter-ca-cert.pem component-access-key.json
Pastikan gkeadm mengaktifkan akun layanan akses komponen di workstation admin Anda:
gcloud config get-value account
Menyalin file kunci JSON ke workstation admin Anda
Sebelum membuat cluster, file kunci JSON untuk akun layanan Anda harus berada di workstation admin di direktori utama.
Kunci untuk akun layanan akses komponen Anda sudah ada di workstation admin.
Jika Anda menyertakan flag --auto-create-service-accounts saat menjalankan
gkeadm create admin-workstation, kunci untuk akun layanan berikut
sudah ada di workstation admin Anda di direktori utama.
Jika tidak, Anda harus menyalin kunci secara manual ke direktori utama workstation admin:
- Akun layanan Connect-register
- Akun layanan logging-monitoring
Jika Anda membuat salah satu akun layanan berikut, Anda harus menyalin kunci untuk akun layanan tersebut secara manual ke direktori utama workstation admin Anda:
- Akun layanan logging audit
- Akun layanan Otorisasi Biner
Memulihkan workstation admin dari file cadangan
Saat Anda mengupgrade workstation admin, perintah gkeadm upgrade
akan menyimpan file cadangan. Nantinya, jika Anda tidak lagi memiliki workstation admin, atau jika Anda kehilangan beberapa file yang ada di workstation admin yang diupgrade, Anda dapat menggunakan file cadangan ini untuk membuat workstation admin yang dipulihkan ke kondisi yang ada segera setelah upgrade.
Untuk membuat workstation admin dari file cadangan, jalankan perintah ini:
gkeadm create admin-workstation --restore-from-backup ADMIN_WORKSTATION_NAME-backup.tar.gz
Ganti ADMIN_WORKSTATION_NAME dengan nama workstation admin.
Dikelola pengguna
Pilih komputer untuk dijadikan sebagai workstation admin Anda. Anda dapat menggunakan Ubuntu atau Red Hat Enterprise Linux (RHEL). Berikut persyaratannya:
Ubuntu 20.04 LTS atau 22.04 LTS
- 4 inti CPU
- RAM 8 GiB
- Penyimpanan 100 GiB
RHEL 8.6, 8.7, atau 8.8
- 4 inti CPU
- RAM 12 GB
- Penyimpanan 256 GiB
Akses ke Google Cloud
Workstation admin Anda harus memiliki akses ke Google Cloud untuk mendownload dan menginstal alat, memproses permintaan otorisasi, membuat akun layanan, dan lainnya.
Untuk mengetahui informasi tentang berbagai cara terhubung ke Google Cloud, lihat Terhubung ke Google.
Akses ke Google Cloud dapat dilakukan secara langsung atau melalui server proxy. Untuk mengetahui informasi tentang aturan firewall dan cara mengonfigurasi server proxy, lihat Aturan proxy dan firewall.
Akses ke vCenter Server
Untuk membuat dan mengelola cluster dari workstation admin, Anda memerlukan akses ke instance vCenter Server. Untuk mengetahui informasinya, lihat:
- Persyaratan vSphere
- Menentukan alamat server vCenter Anda
- Mendapatkan root certificate CA vCenter Anda
Menyiapkan server NTP
Saat cluster dikonfigurasi untuk menggunakan server NTP, Anda perlu menyiapkan layanan sinkronisasi waktu di workstation admin untuk memastikan bahwa timedatectl melaporkan waktu yang disinkronkan dengan cluster. Hal ini diperlukan untuk menghindari masalah
pergeseran jam yang besar, yang dapat menyebabkan kegagalan verifikasi sertifikat karena
tanggal habis masa berlaku yang tidak cocok.
Ubuntu
Sebaiknya gunakan server waktu chrony.
Untuk menginstal chrony:
sudo apt-get update sudo apt install chrony
Tindakan ini menyediakan dua biner:
chronyd- daemon untuk menyinkronkan dan menyajikan melalui Protokol Waktu Jaringan (NTP)chronyc- antarmuka command line untuk daemonchrony
Untuk mengonfigurasi chronyd:
Edit /etc/chrony/chrony.conf untuk menambahkan atau menghapus baris server. Kemudian, mulai ulang
chrony:
sudo systemctl restart chrony.service
RHEL
Sebaiknya gunakan server waktu chrony.
Untuk mengetahui petunjuk penginstalan, lihat Cara mengonfigurasi chrony.
Sudo tanpa sandi
Jika kebijakan keamanan Anda mengizinkan, aktifkan sudo tanpa sandi untuk pengguna saat ini. Hal ini memungkinkan gkectl menyiapkan registry pribadi jika tersedia, menyiapkan proxy untuk Docker jika jaringan Anda berada di belakang server proxy, dan menghapus paksa cluster bootstrap yang digunakan untuk operasi siklus proses cluster admin jika penghapusan gagal.
Jika Anda memilih untuk tidak mengaktifkan sudo tanpa sandi, dan Anda ingin menggunakan registry pribadi untuk cluster admin, lakukan konfigurasi manual berikut sebelum membuat cluster admin:
Tempatkan sertifikat root CA untuk registry pribadi di direktori ini:
/etc/docker/certs.d/REGISTRY_ADDRESS/
Ganti REGISTRY_ADDRESS dengan alamat mesin yang menjalankan registry pribadi.
Untuk mengetahui informasi selengkapnya, lihat Memverifikasi klien repositori dengan sertifikat.
Jika jaringan Anda berada di belakang server proxy, tentukan server proxy dalam file konfigurasi cluster admin, dan konfigurasikan Docker untuk menggunakan server proxy.
Jika Anda memilih untuk tidak mengaktifkan sudo tanpa sandi, Anda mungkin perlu menghapus cluster kind secara manual setelah membuat cluster admin. Untuk mengetahui informasi selengkapnya, lihat Cluster Kind tidak dihapus dalam dokumentasi pemecahan masalah.
Menginstal software
Ubuntu
Instal software berikut:
Docker versi 19.03 atau yang lebih baru: Lihat Menginstal Docker Engine di Ubuntu. Pastikan pengguna non-root adalah anggota grup docker. Lihat Mengelola Docker sebagai pengguna non-root.
Google Cloud CLI versi terbaru: Lihat Menginstal gcloud CLI.
kubectl: Jalankan
gcloud components install kubectl, atau gunakanapt-get:
sudo apt-get update sudo apt-get -y install kubectl
RHEL
Instal software berikut:
Docker 19.03 atau yang lebih baru
Hapus versi Docker sebelumnya:
sudo dnf remove docker \ docker-client \ docker-client-latest \ docker-common \ docker-latest \ docker-latest-logrotate \ docker-logrotate \ docker-engine
Hapus podman-manpages:
sudo dnf remove podman-manpages
Instal Docker 19.03+:
sudo dnf install -y yum-utils sudo yum-config-manager \ --add-repo \ https://download.docker.com/linux/centos/docker-ce.repo sudo dnf install -y --allowerasing docker-ce docker-ce-cli containerd.io sudo systemctl start docker
Pastikan Anda sekarang menjalankan versi 19.03+:
sudo docker version
Bandingkan output Anda dengan contoh berikut untuk memastikan versi Klien dan Server adalah 19.03+:
Client: Docker Engine - Community Version: 19.03.13 ... Server: Docker Engine - Community Engine: Version: 19.03.13
Pastikan Docker berjalan:
docker run hello-world
Anda akan melihat sesuatu yang mirip dengan ini:
Hello from Docker!
This message shows that your installation appears to be working correctly.
Google Cloud CLI versi terbaru:
Baca artikel Menginstal gcloud CLI.
kubectl
Jalankan gcloud components install kubectl.
Login
Akun Google yang ditetapkan sebagai
properti account SDK Anda
disebut akun SDK Anda. Alat command line gkectl menggunakan akun SDK Anda untuk mendownload OVA node cluster, mengambil image container, dan lainnya. Oleh karena itu, penting untuk menetapkan properti akun SDK sebelum menjalankan perintah gkectl.
Login dengan Akun Google apa pun. Tindakan ini akan menetapkan properti account SDK Anda:
gcloud auth login
Pastikan properti account SDK Anda ditetapkan dengan benar:
gcloud config list
Output akan menampilkan nilai properti account SDK Anda.
Contoh:
[core] account = my-name@google.com disable_usage_reporting = False Your active configuration is: [default]
Mendownload gkectl dan paket
Buka direktori tempat Anda ingin menginstal gkectl.
Download gkectl:
gcloud storage cp gs://gke-on-prem-release/gkectl/VERSION/gkectl ./ chmod +x gkectl
Ganti VERSION dengan versi software Google Distributed Cloud khusus untuk VMware. Contoh: 1.16.0-gke.1.
Download paket Google Distributed Cloud khusus software untuk VMware. Pastikan versinya cocok dengan
versi yang Anda gunakan untuk mendownload gkectl:
gcloud storage cp gs://gke-on-prem-release/gke-onprem-bundle/VERSION/gke-onprem-vsphere-VERSION.tgz ./
Akun layanan dan kunci
Pastikan Anda telah membuat akun layanan dan file kunci JSON yang diperlukan berikut:
Pastikan juga Anda telah membuat akun layanan opsional dan file kunci JSON yang diperlukan:
Tempatkan semua file kunci JSON di direktori utama workstation admin Anda.
Pemecahan masalah
Bagian berikut mengaktifkan kembali akses SSH ke workstation admin jika kunci SSH hilang atau rusak.
Pemulihan kunci SSH
Gunakan VM sementara untuk melakukan langkah-langkah berikut:
Untuk membuat kumpulan kunci SSH baru, ikuti petunjuk di bagian Membuat kunci SSH dalam dokumentasi Compute Engine.
Pastikan VM sementara dan workstation admin dalam status
Powered Off.Dalam vSphere, pasang boot disk workstation admin ke VM sementara.
Boot disk memiliki label
Hard disk 1.Pasang boot disk di dalam VM dengan menjalankan perintah berikut:
sudo mkdir -p /mnt/boot-disk sudo mount DISK_ID /mnt/boot-diskGanti
DISK_IDdengan ID boot disk Anda, yang harus memiliki format yang mirip dengan/dev/sdc1.Edit file
authorized_keysdi boot disk untuk menambahkan konten file kunci publik yang dibuat pada langkah pertama:vi /mnt/boot-disk/.ssh/authorized_keysMatikan VM sementara.
Nyalakan workstation admin.
Gunakan kunci pribadi yang baru dibuat untuk mengakses workstation admin.
ssh -i ~/.ssh/new-admin-ws.key ubuntu@ADMIN_WS_IPGanti
ADMIN_WS_IPdengan alamat IP workstation admin Anda.
Gunakan kunci pribadi yang baru dibuat untuk terus mengakses workstation admin Anda.