Penilaian dan Migrasi

Dokumen ini menjelaskan cara melakukan penilaian atas Cloud Foundry (CF) Foundation Anda yang sudah ada, dan cara memigrasikan CF Foundation, Organisasi, Ruang, atau Aplikasi ke Kf.

Penilaian kesesuaian dengan migrasi

Gunakan perintah kf migrate scan-cf-cluster untuk membuat laporan yang berisi penilaian kesiapan migrasi CF Foundation. Anda dapat memformat laporan sebagai spreadsheet (direkomendasikan) atau file teks.

Prasyarat

Kf CLI. Lihat Menginstal Kf CLI untuk mengetahui petunjuk penginstalan.
cf CLI dipanggil sebagai cf.
CLI cf harus ada di jalur Anda.
CLI cf harus diautentikasi dengan hak istimewa hanya baca admin atau yang lebih tinggi di CF Foundation.

Melakukan penilaian

Memvalidasi Yayasan yang akan ditargetkan.
```
cf curl /v2/info
```
Jalankan perintah untuk membuat spreadsheet yang berisi laporan penilaian.

Catatan: Penilaian dijalankan secara lokal di workstation Anda menggunakan Kf CLI, dan tidak ada data yang dikirim ke Google.
```
kf migrate scan-cf-cluster report.xlsx
```
Tinjau penilaian.

Jika berencana membagikan penilaian, Anda dapat menyamarkan informasi yang tidak ingin dibagikan.

Migrasi

Lakukan langkah-langkah berikut untuk memigrasikan entity dari CF:

Buat rencana migrasi yang menjelaskan migrasi.
Edit rencana migrasi untuk menyesuaikan migrasi Anda.
Terapkan rencana migrasi untuk melakukan migrasi.

Bagian berikut menjelaskan langkah-langkah ini secara lebih detail.

Cakupan migrasi

Keputusan pertama Anda saat melakukan migrasi adalah menentukan cakupan migrasi. Cakupan menentukan entity CF yang ingin Anda migrasikan dan hak istimewa yang Anda perlukan untuk melakukan migrasi:

Seluruh Yayasan atau Organisasi: Anda harus memiliki hak istimewa hanya baca admin atau yang lebih tinggi di CF Foundation.
Satu Ruang atau Aplikasi: Anda harus memiliki hak istimewa Developer Ruang atau yang lebih tinggi.

Catatan: Jika memiliki cakupan scim.read dan cloud_controller.admin_read_only, Anda juga dapat membuat kueri semua Aplikasi di semua Ruang dalam Organisasi.

Prasyarat

Untuk melakukan migrasi, Anda memerlukan:

Untuk membuat paket migrasi: Kf CLI. Lihat Menginstal Kf CLI untuk mengetahui petunjuk penginstalan.
Untuk menerapkan rencana migrasi: Cluster GKE yang menjalankan Kf. Lihat Menginstal Kf untuk petunjuk penginstalan.
Akses ke cluster dengan penginstalan Cloud Foundry.
CF CLI yang telah menyasar CF Foundation.
Hak istimewa di CF Foundation yang diperlukan oleh cakupan migrasi yang Anda inginkan, seperti yang ditunjukkan di atas.

Membuat rencana migrasi

Gunakan perintah kf migrate plan untuk membuat rencana migrasi.

Secara default, perintah tersebut menulis rencana migrasi untuk membuat standardisasi. Anda biasanya mengalihkan output ke file yaml sehingga Anda dapat menyesuaikan rencana sebelum menerapkannya. Misalnya, perintah berikut menulis output ke output standar:

kf migrate plan

Alihkan output ke file yaml:

kf migrate plan > plan.yaml

Saat menjalankan perintah kf migrate plan, Anda akan melihat output di jendela perintah dalam formulir di bawah yang mencantumkan langkah-langkah yang dilakukan oleh perintah dan semua masalah peringatan atau migrasi:

kf migrate plan > plan.yaml

    Checking CF CLI is available
    Checking CF CLI is authenticated
    ...

    WARNING: plan has issues
    Issues with domain "apps.internal" in space "kf-team-acceptance":
        E04 - internal domains are not supported

    Issues with application "spring-music" in space "kf-team-app":
        E14 - app manifest must have a single process

    Issues with service instance "logspinner-1" in space "kf-team-app":
        E10 - syslog drain configuration is not supported
    ...

Untuk membuat rencana migrasi:

Pastikan Anda telah login ke CF Foundation menggunakan CF CLI.
Lakukan migrasi berdasarkan cakupan migrasi yang Anda inginkan, dengan:
- MY_ORG menentukan nama Organisasi.
- MY_SPACE menentukan nama Ruang.
- MY_APP menentukan nama Aplikasi.
1. Buat rencana migrasi untuk seluruh CF Foundation.
```
kf migrate plan > plan.yaml
```
2. Buat rencana migrasi untuk Org.
```
kf migrate plan --cf-org MY_ORG > plan.yaml
```
3. Membuat rencana migrasi untuk Ruang
```
kf migrate plan --cf-org MY_ORG --cf-space MY_SPACE > plan.yaml
```
4. Membuat rencana migrasi untuk Aplikasi.
```
kf migrate plan --cf-org MY_ORG --cf-space MY_SPACE --cf-app MY_APP > plan.yaml
```

Jika Anda melihat error berikut setelah menjalankan salah satu perintah ini:

You are not authorized to perform the requested action CF-NotAuthorized 10003

Anda tidak memiliki hak istimewa yang diperlukan untuk membaca endpoint CAPI yang diperlukan.

Mengedit paket migrasi

Tinjau dan ubah rencana migrasi yang dihasilkan secara opsional untuk mengatasi error.

Menerapkan paket migrasi

Gunakan perintah kf migrate apply untuk menerapkan rencana migrasi dan memigrasikan entity CF.

Untuk menerapkan migrasi:

Pastikan Anda telah menetapkan .kubeconfig untuk menargetkan cluster Kf.
Pastikan Anda memiliki akses ke cluster GKE yang menjalankan penginstalan Kf penuh. Artinya, Anda telah menjalankan perintah berikut untuk terhubung ke cluster:
```
gcloud container clusters get-credentials CLUSTER_NAME \
   --project=CLUSTER_PROJECT_ID \
   --zone=CLUSTER_LOCATION
```
Pastikan tidak ada nama Space di cluster Kf Anda yang akan bertabrakan dengan Ruang yang dirujuk dalam rencana migrasi.

Nama ruang memiliki format cf-org-cf-space. Misalnya, jika nama Org adalah myorg dan nama Ruang adalah myspace, ruang Kf adalah myorg-myspace.
Terapkan paket migrasi.
```
kf migrate apply -v --plan plan.yaml
```
Flag panjang -v direkomendasikan, tetapi tidak wajib. Flag ini menyebabkan perintah menghasilkan output perintah Kf yang digunakan untuk melakukan migrasi.

Catatan: Anda mungkin melihat error dari langkah penerapan. Contohnya, E04 - internal domains are not supported Dalam beberapa situasi, Anda dapat mengabaikan error ini dengan menentukan flag --allow-issues. Atau, Anda dapat mengedit rencana migrasi untuk mengatasi error.