Dokumentasi ini ditujukan untuk penayangan Knative versi Terbaru, yang menggunakan fleet dan Anthos Service Mesh. Pelajari lebih lanjut.

Versi sebelumnya (Cloud Run for Anthos) telah diarsipkan, tetapi dokumentasi tetap tersedia untuk pengguna yang sudah ada.

Versi yang tersedia

Terbaru
Arsipkan

Halaman ini diterjemahkan oleh Cloud Translation API.

Memigrasikan workload ke Knative OSS

Gunakan panduan ini untuk memigrasikan workload Anda agar dapat berjalan di penawaran Knative open source dengan Google Kubernetes Engine. Secara umum, untuk memigrasikan workload, Anda harus menginstal komponen Knative Serving di cluster GKE baru, lalu men-deploy ulang setiap layanan ke cluster Knative tersebut.

Meskipun penggunaan, pengelolaan, dan dukungan untuk Knative open source adalah pilihan dan tanggung jawab Anda, bermigrasi ke Knative memberi Anda kesempatan untuk terus menjalankan beban kerja di platform Google Kubernetes Engine.

Perbedaan penting:

Dukungan terbatas untuk Google Kubernetes Engine. Anda dapat menghubungi komunitas Knative untuk dukungan Knative.
Google Cloud CLI (gcloud) hanya didukung oleh Google Kubernetes Engine. Knative mendukung perintah kubectl dan kn. Pelajari cara menginstal kn

Sebelum memulai

Anda harus memiliki akses ke cluster GKE baru.
- Anda dapat membuat cluster baru di project Google Cloud yang sama atau baru.
- Cluster Anda harus memenuhi persyaratan Knative.
- Pelajari cara membuat cluster:
  - Cluster standar
  - Cluster pribadi
Anda harus melakukan transfer konfigurasi cluster apa pun ke cluster Knative baru secara manual, termasuk, tetapi tidak terbatas pada:
Anda harus membuat dan mengonfigurasi kontrol akses IAM dan RBAC baru:
- Mengonfigurasi kontrol akses
- Workload Identity

Menginstal Knative di Google Kubernetes Engine

Knative menyediakan beberapa opsi penginstalan dan lapisan jaringan yang dapat Anda pilih untuk digunakan. Langkah-langkah penginstalan Knative berikut menggunakan metode Operator Knative dan lapisan jaringan Istio.

Instal Operator Knative:

Deploy Operator ke cluster Anda:

kubectl apply -f https://github.com/knative/operator/releases/download/knative-vVERSION/operator.yaml

Ganti VERSION dengan versi Operator Knative.

Contoh:

kubectl apply -f https://github.com/knative/operator/releases/download/knative-v1.3.1/operator.yaml

Tetapkan kubectl CLI untuk menggunakan namespace default:

kubectl config set-context --current --namespace=default

Pastikan Operator berhasil dibuat:

kubectl get deployment knative-operator

Hasil:

NAME               READY   UP-TO-DATE   AVAILABLE   AGE
knative-operator   1/1     1            1           6m43s

Instal komponen Knative Serving:

Buat file YAML dengan hal berikut, misalnya SERVING_FILENAME.yaml:

apiVersion: v1
kind: Namespace
metadata:
  name: knative-serving
---
apiVersion: operator.knative.dev/v1alpha1
kind: KnativeServing
metadata:
  name: knative-serving
  namespace: knative-serving

Deploy file YAML ke cluster Anda:
```
kubectl apply -f SERVING_FILENAME.yaml
```
Ganti SERVING_FILENAME dengan file YAML yang Anda buat.

Instal Istio dengan injeksi sidecar sebagai lapisan jaringan:

Anda memiliki opsi untuk melakukan dan mengonfigurasi penginstalan Istio alternatif. Lihat semua opsi penginstalan Istio di situs Knative. Perhatikan bahwa penginstalan ini dapat memerlukan waktu lebih dari 30 menit atau lebih.
1. Download Istio dari halaman rilis.
2. Instal Istio dengan menjalankan perintah berikut dengan flag --set hub=gcr.io/istio-release untuk menghindari pembatasan kapasitas Docker:
```
istioctl install --set hub=gcr.io/istio-release
```
3. Jalankan perintah berikut untuk mengaktifkan injeksi sidecar:
```
kubectl label namespace default istio-injection=enabled
```
4. Opsional: Secara default, Istio diinstal di namespace istio-system. Jika ingin mengonfigurasi namespace yang berbeda, Anda dapat menggunakan langkah-langkah berikut:
  1. Untuk mengonfigurasi namespace kustom untuk Istion, Anda harus menambahkan atribut spec.config.istio ke file konfigurasi SERVING_FILENAME.yaml. Contoh:
```
apiVersion: operator.knative.dev/v1alpha1
kind: KnativeServing
metadata:
  name: knative-serving
  namespace: knative-serving
spec:
  # ...
  config:
    istio:
      local-gateway.LOCAL_GATEWAY_NAMESPACE.knative-local-gateway: "knative-local-gateway.ISTIO_NAMESPACE.svc.cluster.local"
```
    Ganti:
    - LOCAL_GATEWAY_NAMESPACE adalah namespace tempat Anda menginstal Knative Serving. Default: knative-serving
    - ISTIO_NAMESPACE adalah namespace tempat Istio diinstal. Default: istio-system
  2. Deploy layanan SERVING_FILENAME.yaml yang telah diperbarui ke cluster Knative Anda:
```
kubectl apply -f SERVING_FILENAME.yaml
```
  3. Verifikasi penginstalan Istio dengan mengonfirmasi bahwa istio-ingressgateway berada di namespace yang Anda tentukan:
```
kubectl get svc istio-ingressgateway -n ISTIO_NAMESPACE
```
    Ganti ISTIO_NAMESPACE dengan namespace tempat Anda menginstal Istio. Default: istio-system
    
    Hasil:
```
NAME                   TYPE           CLUSTER-IP      EXTERNAL-IP    PORT(S)                                      AGE
istio-ingressgateway   LoadBalancer   10.232.10.190   34.123.5.116   15021:30337/TCP,80:32549/TCP,443:31210/TCP   119m
```

Memigrasikan layanan

Untuk memigrasikan layanan, Anda men-deploy file konfigurasi YAML layanan ke cluster Knative.

Ekspor layanan penayangan Knative Anda ke file YAML lokal dengan menjalankan perintah berikut:
```
gcloud run services describe SERVICE --format export --namespace NAMESPACE --cluster CLUSTER --platform gke > FILENAME.yaml
```
Ganti:
- SERVICE dengan nama layanan penayangan Knative Anda.
- NAMESPACE dengan namespace tempat layanan Anda berjalan.
- CLUSTER dengan nama cluster tempat layanan Anda berjalan.
- FILENAME dengan nama file unik pilihan Anda.
Ubah file FILENAME.yaml yang diekspor untuk menghapus konfigurasi penayangan Knative yang tidak diinginkan dengan menghapus salah satu atribut berikut beserta nilainya:
- metadata.annotations.kubectl.kubernetes.io/last-applied-configuration
- metadata.managedFields
- spec.template.spec.containers.readinessProbes
- spec.template.spec.enableServiceLinks
  
  Misalnya, Anda mungkin perlu menghapus konfigurasi berikut dari atribut spec: > template: > spec: > containers::
```
...
 readinessProbe:
   successThreshold: 1
   tcpSocket: {}
...
```
Deploy file .yaml yang diubah ke cluster Knative Anda:
```
kubectl apply -f SERVICE.yaml
```
Ganti SERVICE dengan nama file konfigurasi layanan Anda.
Akses layanan yang di-deploy menggunakan domain pengujian atau perintah cURL. Anda dapat menggunakan layanan DNS karakter pengganti untuk menguji akses eksternal ke layanan Anda. Lihat bagian mengonfigurasi DNS dalam dokumen Knative untuk mengetahui opsi lainnya.

Untuk menggunakan Magic DNS (sslip.io), jalankan perintah berikut.

Perhatikan bahwa Anda juga dapat langsung menggunakan sslip.io.
```
kubectl apply -f https://github.com/knative/serving/releases/download/knative-vVERSION/serving-default-domain.yaml
```
Ganti VERSION dengan versi Knative Serving Anda.

Contoh:
```
kubectl apply -f https://github.com/knative/serving/releases/download/knative-v1.3.0/serving-default-domain.yaml
```

Memigrasikan traffic ke layanan Anda

Setelah menguji layanan yang baru di-deploy dan siap memigrasikan semua traffic produksi, Anda dapat mengonfigurasi domain kustom dan memperbarui data DNS dengan registrar. Ikuti petunjuk di Mengonfigurasi domain kustom.