Menilai dan memigrasikan Cloud Foundry

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

Penilaian kesesuaian 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 diinstal sebagai cf.
CLI cf harus berada di jalur Anda.
CLI cf harus diautentikasi dengan hak istimewa admin hanya baca atau yang lebih tinggi di CF Foundation.

Melakukan penilaian

Validasi Foundation 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 apa pun 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 entitas CF yang ingin Anda migrasikan dan hak istimewa yang Anda perlu untuk melakukan migrasi:

Seluruh Yayasan atau Organisasi: Anda harus memiliki hak istimewa admin hanya baca atau yang lebih tinggi di Yayasan CF.
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 untuk semua Aplikasi di semua Ruang dalam Organisasi.

Prasyarat

Untuk melakukan migrasi, Anda memerlukan:

Untuk membuat rencana 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 menargetkan 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 menulis rencana migrasi ke output standar. 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 bentuk di bawah yang mencantumkan langkah-langkah yang dilakukan oleh perintah dan 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
    ...

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. Membuat rencana migrasi untuk seluruh CF Foundation.
```
kf migrate plan > plan.yaml
```
2. Membuat rencana migrasi untuk Organisasi.
```
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 rencana migrasi

Tinjau dan ubah rencana migrasi yang dihasilkan jika perlu untuk mengatasi error.

Menerapkan rencana migrasi

Gunakan perintah kf migrate apply untuk menerapkan rencana migrasi dan memigrasikan entitas CF:

Pastikan Anda telah menetapkan .kubeconfig untuk menargetkan cluster Kf.
Pastikan Anda memiliki akses ke cluster GKE yang menjalankan penginstalan Kf lengkap. 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 Ruang yang ada di cluster Kf Anda yang akan bentrok dengan Ruang yang dirujuk dalam rencana migrasi.

Nama ruang berbentuk cf-org-cf-space. Misalnya, jika nama Organisasi adalah myorg dan nama Ruang adalah myspace, maka ruang Kf akan menjadi myorg-myspace.
Terapkan rencana migrasi.
```
kf migrate apply -v --plan plan.yaml
```
Flag panjang -v direkomendasikan, tetapi tidak wajib. Flag ini menyebabkan perintah menghasilkan 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 tanda --allow-issues. Atau, Anda dapat mengedit rencana migrasi untuk mengatasi error tersebut.