Menggunakan alat command line nomos
Alat command line nomos
adalah alat opsional untuk Config Sync yang
dapat Anda gunakan untuk mendapatkan status Config Sync dan status sinkronisasi
sumber kebenaran. Alat
nomos
menyediakan perintah berikut:
Perintah | Penggunaan |
---|---|
nomos status |
Memeriksa status Config Sync |
nomos vet |
Memeriksa error dalam sumber tepercaya |
nomos hydrate |
Melihat semua konfigurasi di sumber tepercaya |
nomos bugreport |
Membuat laporan bug |
nomos migrate |
Melakukan migrasi dari objek ConfigManagement ke RootSync |
nomos init |
Melakukan inisialisasi sumber kebenaran hierarkis |
Prasyarat
Sebelum Anda dapat menggunakan alat nomos
untuk berinteraksi dengan cluster, Config Sync harus sudah diinstal di cluster target. Anda juga harus
menginstal dan mengonfigurasi alat command line kubectl
.
Jika berinteraksi dengan cluster Google Kubernetes Engine, pastikan Anda juga menginstal gke-gcloud-auth-plugin
.
Alat nomos
mendukung pratinjau dan validasi konfigurasi Kustomize dan diagram Helm. Sebelum Anda dapat menggunakan fitur ini, instal Kustomize dan Helm di workstation lokal Anda. Jika sumber tepercaya Anda hanya berisi konfigurasi
yang dirender sepenuhnya, Kustomize dan Helm bersifat opsional.
Menginstal alat nomos
Alat nomos
adalah biner yang dikompilasi dari kode Go dan Anda dapat menginstalnya
secara lokal, misalnya, di workstation atau laptop.
Alat nomos
tidak disertakan saat Anda menginstal Config Sync. Anda dapat menginstal alat nomos
dengan menginstal Google Cloud CLI. Jika Anda menggunakan Cloud Shell, Google Cloud CLI sudah terinstal.
Jika tidak memiliki Google Cloud CLI, sebaiknya gunakan gcloud components install nomos
untuk menginstal alat nomos
. Dengan menginstal alat nomos
dengan Google Cloud CLI, Anda dapat menggunakan gcloud components update
untuk mengupdate alat nomos
ke versi terbaru.
Untuk mengetahui informasi tentang cara alternatif menginstal alat nomos
, lihat
Download.
Penggunaan dasar
Untuk sintaksis perintah dasar, gunakan argumen --help
:
nomos --help
Alat nomos
membaca dari clone lokal sumber kebenaran Anda. Gunakan flag --path
untuk menentukan lokasi tingkat atas sumber tepercaya. Secara default,
--path
ditetapkan ke .
, atau direktori saat ini. Contoh:
nomos --path=PATH_TO_SOURCE vet
Memeriksa status Config Sync
Anda dapat memantau status Config Sync pada semua cluster terdaftar menggunakan perintah nomos status
. Untuk setiap cluster, nomos status
melaporkan hash commit yang terakhir diterapkan ke cluster dan error yang terjadi saat mencoba menerapkan perubahan terbaru.
Anda juga dapat menggunakan nomos status
untuk memeriksa apakah resource yang dikelola oleh
Config Sync sudah siap. nomos status
melaporkan status untuk setiap
resource di kolom STATUS
pada bagian Managed resources
output.
Contoh berikut menunjukkan beberapa kondisi berbeda yang mungkin dilaporkan oleh perintah nomos status
:
nomos status
Contoh output:
MANAGED_CLUSTER_1
--------------------
<root> git@github.com:foo-corp/acme@main
SYNCED f52a11e4
Managed resources:
NAMESPACE NAME STATUS
k8snoexternalservices.constraints.gatekeeper.sh/no-internet-services Current
namespace/hello Current
MANAGED_CLUSTER_2
--------------------
<root> git@github.com:foo-corp/acme@main
PENDING 9edf8444
MANAGED_CLUSTER_3
--------------------
<root> git@github.com:foo-corp/acme@main
ERROR f52a11e4
Error: KNV1021: No CustomResourceDefinition is defined for the resource in the cluster.
MANGED_CLUSTER_4
--------------------
NOT INSTALLED
MANAGED_CLUSTER_5
--------------------
<root> git@github.com:foo-corp/acme/admin@main
SYNCED f52a11e4
Managed resources:
NAMESPACE NAME STATUS
namespace/gamestore Current
namespace/monitoring Current
gamestore reposync.configsync.gke.io/repo-sync Current
gamestore rolebinding.rbac.authorization.k8s.io/gamestore-admin Current
gamestore rolebinding.rbac.authorization.k8s.io/gamestore-webstore-admin Current
monitoring deployment.apps/prometheus-operator Current
monitoring prometheus.monitoring.coreos.com/acm Current
monitoring service/prometheus-acm Current
monitoring service/prometheus-operator Current
monitoring serviceaccount/prometheus-acm Current
monitoring serviceaccount/prometheus-operator Current
monitoring servicemonitor.monitoring.coreos.com/acm-service Current
--------------------
bookstore git@github.com:foo-corp/acme/bookstore@v1
SYNCED 34d1a8c8
Managed resources:
NAMESPACE NAME STATUS
gamestore configmap/store-inventory Current
gamestore webstore.marketplace.com/gameplace Current
Dalam output ini:
MANAGED_CLUSTER_1
telah menyinkronkan perubahan terbaru ke sumber tepercaya dan semua resource terkelola memiliki statusCurrent
. StatusCurrent
berarti status resource cocok dengan status yang Anda inginkan.MANAGED_CLUSTER_2
masih disinkronkan.MANAGED_CLUSTER_3
memiliki error yang mencegah perubahan diterapkan. Dalam contoh ini,MANAGED_CLUSTER_3
memiliki error KNV1021 karena tidak memiliki CustomResourceDefinition (CRD) yang telah diinstal oleh cluster lain.MANAGED_CLUSTER_4
tidak menginstal Config Sync.MANAGED_CLUSTER_5
menyinkronkan dari dua repositori Git. Sumber tepercaya<root>
adalah milik admin cluster dan sumber tepercayabookstore
mungkin milik tim pengembangan aplikasi.
Status resource terkelola
Status resource terkelola dapat berupa salah satu nilai berikut:
InProgress
: Status resource yang sebenarnya belum mencapai status yang Anda tentukan dalam manifes resource. Status ini berarti rekonsiliasi resource belum selesai. Resource yang baru dibuat biasanya diawali dengan status ini, meskipun beberapa resource seperti ConfigMaps langsungCurrent
.Failed
: Proses merekonsiliasi status sebenarnya dengan status yang Anda inginkan mengalami error atau progresnya tidak mencukupi.Current
: Status resource sebenarnya cocok dengan status yang Anda inginkan. Proses rekonsiliasi dianggap selesai sampai ada perubahan pada status yang diinginkan atau status yang sebenarnya.Terminating
: Resource dalam proses dihapus.NotFound
: Resource tidak ada di cluster.Unknown
: Config Sync tidak dapat menentukan status resource.
Untuk tidak menampilkan status level resource, tambahkan --resources=false
ke
perintah nomos status
.
Tentang commit yang terakhir disinkronkan
Perintah nomos status
menampilkan hash commit terbaru yang
diterapkan ke cluster dalam outputnya di bagian status.sync.commit
. Untuk mendapatkan nilai
ini, buat kueri objek RootSync
atau RepoSync
, lalu lihat kolom
status.sync
.
Misalnya, untuk membuat kueri objek RootSync
, jalankan perintah berikut:
kubectl get rootsyncs.configsync.gke.io -n config-management-system root-sync -o yaml
Contoh output:
apiVersion: configsync.gke.io/v1beta1
kind: RootSync
status:
sync:
commit: f1739af550912034139aca51e382dc50c4036ae0
lastUpdate: "2021-04-20T00:25:01Z"
Untuk membuat kueri objek RepoSync
, jalankan perintah berikut:
kubectl get reposync.configsync.gke.io -n NAMESPACE repo-sync -o yaml
Ganti NAMESPACE
dengan namespace tempat Anda membuat
sumber kebenaran namespace.
Contoh output:
apiVersion: configsync.gke.io/v1beta1
kind: RepoSync
status:
sync:
commit: ed95b50dd918cf65d8908f7561cb8d8d1f179c2f
lastUpdate: "2021-04-20T00:25:20Z"
Commit ini mewakili commit terbaru terhadap cluster. Namun, tidak
semua resource dalam cluster terpengaruh oleh setiap commit; untuk melihat commit terbaru
untuk resource tertentu, buat kueri resource spesifik dan lihat
metadata.annotations.configmanagement.gke.io/token
. Contoh:
kubectl get clusterroles CLUSTER_ROLE_NAME -o yaml
Ganti CLUSTER_ROLE_NAME
dengan nama peran cluster yang ingin Anda buat kuerinya.
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
annotations:
configmanagement.gke.io/token: ed95b50dd918cf65d8908f7561cb8d8d1f179c2f
flag status nomos
Untuk menyesuaikan perintah nomos status
, tambahkan flag berikut:
Tanda | Deskripsi |
---|---|
--contexts |
Menerima daftar konteks yang dipisahkan koma untuk digunakan dalam perintah multi-cluster. Setelan defaultnya adalah semua konteks. Gunakan "" jika tidak ada konteks. |
-h atau --help |
Bantuan untuk perintah nomos status . |
--namespace |
Menerima string. Gunakan flag namespace untuk membatasi
perintah ke sumber tepercaya namespace tertentu. Biarkan tidak disetel untuk
mendapatkan semua sumber. Flag ini hanya tersedia jika Anda mengaktifkan
sinkronisasi dari lebih dari satu sumber tepercaya. |
--poll |
Gunakan flag poll untuk menjalankan
nomos status secara terus-menerus dan membuatnya mencetak ulang tabel
status pada interval yang teratur. Contohnya, 3s . Biarkan tanda ini
tidak disetel untuk menjalankan nomos status sekali |
--resources |
Menerima true atau false . Jika true ,
nomos status menampilkan status level resource untuk sumber tepercaya
root atau namespace saat melakukan sinkronisasi dari lebih dari satu sumber tepercaya.
Nilai defaultnya adalah true . |
--timeout |
Waktu tunggu untuk terhubung ke setiap cluster. Nilai defaultnya adalah
3s . |
--name |
Menerima string. Gunakan flag ini untuk memfilter Sinkronisasi Root dan Repo dengan
nama yang disediakan. Flag ini dapat digunakan bersama
flag namespace . |
Izin yang diperlukan
Jika adalah pemilik project, Anda memiliki peran RBAC cluster-admin
dan dapat
menggunakan perintah nomos status
untuk cluster apa pun dalam project tanpa menambahkan
izin lebih lanjut. Jika tidak memiliki peran cluster-admin
, Anda dapat menggunakan nomos status
dengan membuat ClusterRole berikut:
Buat file bernama
nomos-status-reader.yaml
dan salin ClusterRole berikut ke dalamnya. Aturan yang Anda perlukan berbeda-beda bergantung pada apakah Anda menggunakan objek RootSync dan RepoSync.Menggunakan objek RootSync dan RepoSync
# nomos-status-reader.yaml apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: name: nomos-status-reader rules: - apiGroups: ["configsync.gke.io"] resources: ["reposyncs", "rootsyncs"] verbs: ["get"] - nonResourceURLs: ["/"] verbs: ["get"]
Tidak menggunakan objek RootSync dan RepoSync
apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: name: nomos-status-reader rules: - apiGroups: ["configmanagement.gke.io"] resources: ["configmanagements", "repos"] verbs: ["get", "list"] - nonResourceURLs: ["/"] verbs: ["get"]
Terapkan file
nomos-status-reader.yaml
:kubectl apply -f nomos-status-reader.yaml
Memeriksa error dalam sumber tepercaya
Sebelum meng-commit konfigurasi ke sumber tepercaya, gunakan perintah nomos vet
untuk memeriksa sintaksis dan validitas konfigurasi di sumber kebenaran:
nomos vet
Jika ditemukan error sintaksis, perintah nomos vet
akan keluar dengan status bukan nol
dan mencatat pesan error ke STDERR
.
bendera dokter hewan nomos
Untuk menyesuaikan perintah nomos vet
, tambahkan flag berikut:
Tanda | Deskripsi |
---|---|
--clusters |
Menerima daftar nama cluster yang dipisahkan koma untuk digunakan dalam perintah multi-cluster. Setelan defaultnya adalah semua cluster. Gunakan "" jika tidak ada cluster. |
-h atau --help |
Bantuan untuk perintah nomos vet . |
--namespace |
Menerima string. Jika ditetapkan, memvalidasi sumber kebenaran sebagai sumber kebenaran namespace dengan nama yang diberikan. Otomatis menetapkan --source-format=unstructured . |
--no-api-server-check |
Menerima Boolean. Jika true , menonaktifkan komunikasi dengan server API agar ditemukan. Untuk mengetahui informasi selengkapnya tentang tanda ini, lihat bagian Validasi sisi server. |
--path |
Menerima string. Jalur ke direktori utama sumber tepercaya Config Sync Anda. Defaultnya adalah ". " |
--source-format |
Menerima hierarchy atau unstructured . Jika
hierarchy atau tidak disetel, akan memvalidasi sumber kebenaran sebagai
sumber kebenaran hierarkis. Jika
unstructured , memvalidasi sumber kebenaran sebagai
sumber kebenaran tidak terstruktur.
Flag ini diperlukan jika Anda menggunakan sumber tepercaya yang tidak terstruktur. |
--keep-output |
Menerima Boolean. Jika true , output yang dirender akan disimpan ke
lokasi yang dapat Anda tentukan dengan tanda --output . |
--output |
Menerima string. Jalur ke output yang dirender. Default-nya adalah direktori
compiled . Jika --keep-output ditetapkan ke false , flag ini akan diabaikan. |
--format |
Menerima yaml atau json . Format
output. Nilai defaultnya adalah yaml . |
Validasi sisi server
Jika perintah nomos vet
tidak dapat menentukan apakah jenisnya memiliki namespace, alat
nomos
akan terhubung ke Server API. Karena secara default alat nomos
memahami jenis Kubernetes inti dan CRD Config Sync, alat ini hanya mencoba terhubung ke Server API jika ada CR yang tidak memiliki CRD dideklarasikan yang sesuai. Dalam hal ini, jika Server API tidak menerapkan CRD, perintah nomos
vet
akan menampilkan error KNV1021. Untuk
menonaktifkan pemeriksaan ini dan menyembunyikan error dari CRD yang tidak ada, teruskan tanda --no-api-
server-check
.
Menyimpan metadata server API dalam cache
Daripada menyembunyikan pemeriksaan server API, Anda dapat meng-cache data di server API untuk perintah nomos vet
. Untuk meng-cache api-resources
, selesaikan langkah-langkah berikut:
- Hubungkan ke cluster yang memiliki semua CRD yang diperlukan untuk sumber tepercaya Anda. Cluster tidak perlu mengaktifkan Config Sync.
- Buka policyDir dari sumber tepercaya Anda. Ini adalah direktori yang sama dengan yang ditentukan dalam resource ConfigManagement atau RootSync.
- Jalankan perintah berikut:
kubectl api-resources > api-resources.txt
Perintah ini membuat file bernama api-resources.txt yang berisi output yang sama persis dari kubectl api-resources.
Mulai sekarang, menjalankan nomos vet
dalam sumber tepercaya akan mengetahui definisi jenis tersebut. Jika file api-resources.txt
dihapus atau diganti namanya, nomos vet
tidak dapat menemukan file tersebut. nomos vet
akan tetap mencoba terhubung ke cluster
jika menemukan manifes untuk jenis yang tidak dideklarasikan di api-resources.txt
(kecuali --no-api-server-check
diteruskan).
File api-resources.txt
hanya memengaruhi cara kerja alat nomos
. Konfigurasi ini tidak mengubah perilaku Config Sync dengan cara apa pun.
Anda boleh memiliki entri tambahan dalam file api-resources.txt untuk jenis yang tidak ada dalam sumber kebenaran yang sedang divalidasi. nomos vet
mengimpor definisi, tetapi tidak melakukan apa pun pada definisi tersebut.
Mengupdate api-resources.txt
Setelah memastikan semua CRD yang Anda inginkan berada di cluster, jalankan perintah berikut:
kubectl api-resources > api-resources.txt
Judul kolom tidak cocok di api-resources
Kubernetes versi 1.20 dan yang lebih baru mengganti kolom bernama APIGROUP
dengan APIVERSION
. Untuk nomos versi 1.16.1 dan yang lebih lama, penggunaan api-resources.txt
akan menyebabkan
error:
[1] KNV1064: unable to find APIGROUP column. Re-run "kubectl api-resources > api-resources.txt" in the root policy directory
Untuk mengurangi masalah ini, ganti APIVERSION
di api-resources.txt
kembali ke APIGROUP
secara manual.
Periksa secara otomatis kesalahan sintaks saat melakukan commit
Jika Anda meng-commit file dengan error JSON atau YAML, Config Sync tidak akan menerapkan perubahan tersebut. Namun, Anda dapat mencegah jenis error ini agar tidak membuka sumber kebenaran dengan menggunakan hook sisi klien atau sisi server.
Menggunakan nomos vet
di hook pra-commit
Anda dapat mengonfigurasi hook pra-commit yang menjalankan perintah nomos vet
untuk memeriksa
error sintaksis saat Anda melakukan perubahan pada clone Git lokal dari repo Anda.
Jika hook pra-commit keluar dengan status bukan nol, operasi git commit
akan gagal.
Untuk menjalankan perintah nomos vet
sebagai hook pra-commit, edit
file .git/hooks/pre-commit
di sumber tepercaya (perhatikan bahwa .git
dimulai dengan karakter
.
). Anda mungkin perlu membuat file secara manual. Tambahkan perintah nomos vet
ke baris baru dalam skrip. Argumen --path
bersifat opsional.
nomos vet --path=/path/to/repo
Pastikan bahwa file pre-commit
dapat dieksekusi:
chmod +x .git/hooks/pre-commit
Sekarang, saat Anda menjalankan perintah git commit
dalam clone sumber tepercaya,
nomos vet
akan berjalan secara otomatis.
Konten direktori .git/
tidak dilacak oleh
sumber kebenaran itu sendiri, dan tidak dapat di-commit ke sumber tepercaya di lokasi
yang sama. Anda dapat membuat direktori di sumber tepercaya untuk hook Git, dan orang yang menggunakan sumber tepercaya dapat menyalin hook ke tempat yang sesuai dalam clone lokal mereka.
Menggunakan nomos vet
di hook sisi server
Git menyediakan mekanisme untuk menjalankan pemeriksaan di server, bukan
klien, selama operasi git push
. Jika pemeriksaan gagal, git push
juga
akan gagal. Hook sisi server ini tidak dapat diabaikan oleh klien. Metode untuk mengonfigurasi hook sisi server bergantung pada cara server Git Anda dihosting. Lihat salah satu link berikut untuk informasi selengkapnya, atau periksa dokumentasi untuk layanan hosting Git Anda.
Melihat semua konfigurasi di sumber tepercaya
Anda dapat menggunakan perintah nomos hydrate
untuk melihat gabungan konten
sumber tepercaya pada setiap cluster yang terdaftar.
Jika Anda menjalankan nomos hydrate
tanpa opsi, direktori compiled/
akan dibuat di direktori kerja saat ini. Dalam direktori tersebut, subdirektori akan dibuat untuk setiap cluster yang terdaftar, dengan konfigurasi yang telah diselesaikan sepenuhnya yang akan diterapkan Operator ke cluster tersebut.
Perintah ini juga dapat mengonversi sumber kebenaran hierarkis
menjadi satu atau beberapa sumber kebenaran tidak terstruktur,
dengan menggunakan konten di direktori compiled/
.
bendera nomos hydrate
Untuk menyesuaikan perintah nomos hydrate
, tambahkan flag berikut:
Tanda | Deskripsi |
---|---|
--clusters |
Menerima daftar nama cluster yang dipisahkan koma. Gunakan flag ini untuk membatasi output ke satu cluster atau daftar cluster. Setelan defaultnya adalah semua cluster. Gunakan "" jika tidak ada cluster. |
--flat |
Jika diaktifkan, cetak semua output menjadi satu file. Gunakan flag ini jika Anda ingin mengemulasi perilaku nomos view . |
-h atau --help |
Bantuan untuk perintah nomos hydrate . |
--format |
Menerima yaml atau json . Format
output. Nilai defaultnya adalah yaml . |
--no-api-server-check |
Menerima Boolean. Jika true , menonaktifkan komunikasi dengan server API agar ditemukan. Untuk mengetahui informasi selengkapnya tentang tanda ini, lihat bagian Validasi sisi server. |
--output |
Menerima string. Lokasi untuk menulis konfigurasi terhidrasi. Defaultnya adalah direktori compiled .
Jika --flat tidak diaktifkan, setiap manifes resource akan ditulis sebagai
file terpisah.
Jika --flat diaktifkan, menulis ke, akan menulis satu file
yang menyimpan semua manifes resource.
|
--path |
Menerima string. Jalur ke direktori utama sumber tepercaya Config Sync Anda. Defaultnya adalah ". " |
--source-format |
Menerima hierarchy atau unstructured . Jika
hierarchy atau tidak disetel, akan memvalidasi sumber kebenaran sebagai
sumber kebenaran hierarkis. Jika
unstructured , memvalidasi sumber kebenaran sebagai
sumber kebenaran tidak terstruktur.
Flag ini diperlukan jika Anda menggunakan sumber tepercaya yang tidak terstruktur. |
Buat laporan bug
Jika mengalami masalah dengan Config Sync yang memerlukan bantuan dari dukungan Google Cloud, Anda dapat memberikan informasi proses debug yang berharga kepada mereka menggunakan perintah nomos bugreport
. Anda dapat menggunakan perintah ini untuk satu sumber tepercaya dan beberapa repositori.
nomos bugreport
Perintah ini menghasilkan file ZIP dengan stempel waktu yang berisi informasi tentang cluster Kubernetes yang ditetapkan dalam konteks kubectl
. File ini juga berisi log dari
Pod Config Sync. File ini tidak berisi informasi dari resource yang disinkronkan dengan Config Sync. Untuk mengetahui informasi selengkapnya tentang isi file zip,
lihat referensi laporan bug nomos.
Batasan
Perintah nomos bugreport
gagal dan menghasilkan file ZIP yang tidak lengkap jika setiap file melebihi 1 GiB. Hal ini sering terjadi karena ukuran file log yang besar.
Tabel berikut berisi penyebab paling umum file log berukuran besar dan cara menyelesaikannya:
Penyebab | Tindakan yang disarankan |
---|---|
Panjang log meningkat | Mengurangi panjang log dengan log level overrides |
Objek yang sangat besar | Tidak mengelola objek besar atau mengurangi ukurannya |
Banyak objek | Membagi repositori Anda menjadi beberapa repositori |
Pengontrol pertarungan | Selesaikan pertarungan |
Bermigrasi dari objek ConfigManagement ke objek RootSync
Anda dapat menjalankan perintah nomos migrate
untuk bermigrasi dari objek ConfigManagement ke objek RootSync untuk mengaktifkan API RootSync
dan RepoSync
. Perintah
ini tersedia di alat nomos
versi 1.10.0 dan yang lebih baru.
nomos migrate
mendukung uji coba untuk melihat pratinjau proses migrasi.
nomos migrate
mengubah objek ConfigManagement di cluster secara langsung.
Agar perubahan yang dilakukan melalui nomos migrate
tidak dikembalikan, pastikan
objek ConfigManagement tidak diperiksa ke sumber tepercaya Anda.
nomos migrate --contexts=KUBECONFIG_CONTEXTS --dry-run
Jika hasil uji coba terlihat bagus, Anda dapat memigrasikan objek ConfigManagement
dengan menggunakan nomos migrate
:
nomos migrate --contexts=KUBECONFIG_CONTEXTS
Outputnya mirip dengan hal berikut ini:
--------------------
Enabling the multi-repo mode on cluster "my_managed_cluster-1" ...
- A RootSync object is generated and saved in "/tmp/nomos-migrate/my_managed_cluster-1/root-sync.yaml".
- The original ConfigManagement object is saved in "/tmp/nomos-migrate/my_managed_cluster-1/cm-original.yaml".
- The ConfigManagement object is updated and saved in "/tmp/nomos-migrate/my_managed_cluster-1/cm-multi.yaml".
- Resources for the multi-repo mode have been saved in a temp folder. If the migration process is terminated, it can be recovered manually by running the following commands:
kubectl apply -f /tmp/nomos-migrate/my_managed_cluster-1/cm-multi.yaml && \
kubectl wait --for condition=established crd rootsyncs.configsync.gke.io && \
kubectl apply -f /tmp/nomos-migrate/my_managed_cluster-1/root-sync.yaml.
- Updating the ConfigManagement object ....
- Waiting for the RootSync CRD to be established ....
- The RootSync CRD has been established.
- Creating the RootSync object ....
- Waiting for the reconciler-manager Pod to be ready ....
- Haven't detected running Pods with the label selector "app=reconciler-manager".
- Haven't detected running Pods with the label selector "app=reconciler-manager".
- Haven't detected running Pods with the label selector "app=reconciler-manager".
- The reconciler-manager Pod is running.
- Waiting for the root-reconciler Pod to be ready ....
- Haven't detected running Pods with the label selector "configsync.gke.io/reconciler=root-reconciler".
- Haven't detected running Pods with the label selector "configsync.gke.io/reconciler=root-reconciler".
- Haven't detected running Pods with the label selector "configsync.gke.io/reconciler=root-reconciler".
- The root-reconciler Pod is running.
- The migration process is done. Please check the sync status with `nomos status`.
Finished migration on all the contexts. Please check the sync status with `nomos status`.
Roll back ke konfigurasi sebelumnya
Jika Anda perlu melakukan roll back setelah melakukan migrasi dengan nomos migrate
, terapkan objek ConfigManagement asli. nomos migrate
menyimpan objek ConfigManagement asli ke file dan mencetak nama ke terminal.
Nama filenya adalah /tmp/nomos-migrate/CURRENT_CONTEXT/cm-original.yaml
.
Untuk melakukan roll back ke konfigurasi sebelumnya, salin jalur file untuk cm-original.yaml
dan terapkan file tersebut ke cluster Anda:
kubectl apply -f CM_ORIGINAL_PATH
tanda migrasi nomos
Untuk menyesuaikan perintah nomos migrate
, tambahkan flag berikut:
Tanda | Deskripsi |
---|---|
--connect-timeout |
Menerima durasi. Durasi waktu tunggu untuk terhubung ke setiap cluster.
Default-nya adalah 3s . |
--contexts |
Menerima daftar konteks yang dipisahkan koma untuk digunakan di lingkungan multi-cluster. Setelan defaultnya adalah konteks saat ini. Gunakan "all" untuk semua konteks. |
--dry-run |
Menerima boolean. Jika true , hanya mencetak output migrasi. |
-h atau --help |
Bantuan untuk perintah nomos migrate . |
--wait-timeout |
Menerima durasi. Durasi waktu tunggu untuk menunggu kondisi resource Kubernetes benar. Nilai defaultnya adalah 10m . |
Melakukan inisialisasi sumber kebenaran hierarkis
Anda dapat mengatur sumber kebenaran secara arbitrer jika menggunakan
sumber kebenaran tidak terstruktur.
Jika menggunakan sumber kebenaran hierarkis, Anda harus menjalankan perintah nomos init
untuk menginisialisasi direktori hierarkis:
nomos init
Hal ini akan membuat struktur direktori dasar dari sumber tepercaya hierarkis, termasuk
direktori system/
, cluster/
, dan namespaces/
.
flag init nomos
Untuk menyesuaikan nomos init
, tambahkan flag berikut:
Tanda | Deskripsi |
---|---|
--force |
Menulis ke direktori meskipun tidak kosong, akan menimpa file yang mengalami konflik |
-h atau --help |
Bantuan untuk perintah nomos init . |
--path |
Menerima string. Direktori utama yang akan digunakan untuk
sumber kebenaran Anda. Nilai defaultnya adalah "." |
Pemecahan masalah
Di Linux, Anda mungkin melihat error berikut saat menjalankan perintah nomos
:
failed to create client configs: while getting config path: failed to get current user: user: Current not implemented on linux/amd64
Untuk memperbaiki masalah ini, buat variabel lingkungan USER
:
export USER=$(whoami)