Ta strona została przetłumaczona przez Cloud Translation API.

Wymagania wstępne integracji Kubernetes

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

W tym temacie opisano czynności, które musisz wykonać przed zainstalowaniem Edge Microgateway jako usługi w klastrze Kubernetes.

Ten temat dotyczy:

Minimalne wymagania dotyczące klastra Kubernetes.
Jak zainstalować i skonfigurować Edge Microgateway
Jak zainstalować podstawową konfigurację Edge Microgateway w klastrze Kubernetes.

Wymagania dotyczące klastra Kubernetes

Klaster Kubernetes wymaga:

Kubernetes w wersji 1.9 lub nowszej.
interfejs wiersza poleceń Kubernetes kubectl w wersji 1.9 lub nowszej,
klaster z co najmniej 3 węzłami z 2 procesorami wirtualnymi na węzeł;

Przykład: tworzenie klastra Kubernetes w Google Kubernetes Engine (GKE)

Konfigurowanie maszyny do administrowania Kubernetes

Maszyna administracyjna Kubernetes to lokalna maszyna, na której uruchamiasz polecenia w klastrze Kubernetes. Jest to zwykle komputer stacjonarny z dostępem do maszyn wirtualnych Kubernetes.

Na maszynie administracyjnej Kubernetes musisz zainstalować te narzędzia:

Zainstaluj interfejs wiersza poleceń kubectl w wersji 1.9 lub nowszej.
(dotyczy tylko GKE) Zainstaluj gcloud, jeśli używasz Kubernetes w GKE.

Tworzenie klastra Kubernetes w GKE

Zaloguj się na panel Google Kubernetes Engine (GKE) w Google Cloud Platform (GCP).
Kliknij Utwórz klaster.
Wybierz Standardowy klaster.
Wpisz nazwę klastra.
Wybierz strefę.
Wybierz Cluster Version 1.9.7-gke-*. Na przykład 1.9.7-gke.6.
Wybierz rozmiar 3 węzłów.
Wybierz 2 procesory wirtualne z 7,5 GB pamięci.
Kliknij Utwórz.

Na poniższym zrzucie ekranu widać panel GKE wypełniony zgodnie z opisem w poprzednich krokach:

Pobieranie danych logowania do klastra

Ustaw nazwę projektu GKE:
```
gcloud config set project projectName
```
Ustaw strefę projektu GKE:
```
gcloud config set compute/zone zoneName
```

Uzyskaj dane logowania do kontenera gcloud:

gcloud container clusters get-credentials cluster-name --zone zone --project project-name

gdzie:

cluster-name to nazwa utworzonego klastra Kubernetes.
zone to strefa, w której znajduje się klaster.
project-name to nazwa Twojego projektu GCP.

Na przykład:

gcloud container clusters get-credentials edgemicrogateway-cluster --zone us-central1-a --project edgemicro-project

Wykonaj podane niżej polecenie w podanej kolejności. To polecenie przyznaje użytkownikowi uprawnienia administratora klastra. Aby utworzyć wymagane reguły RBAC dla usługi Edge Microgateway, musisz mieć uprawnienia administratora:
```
kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=$(gcloud config get-value core/account)
```

Instalowanie Edge Microgateway w Kubernetes

Pobierz Edge Microgateway dla Kubernetes. Jeśli używasz komputera z systemem macOS lub Linux, możesz pobrać najnowszą wersję lub konkretną wersję, podając jej nazwę.

Aby pobrać najnowszą wersję:

curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -

Aby uzyskać konkretną wersję, podając jej numer. Pamiętaj, że numer wersji musi być poprzedzony literą „v”. Na przykład: v3.0.2

curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s  version

Na przykład:

curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s v3.0.2

Zmień katalog na katalog instalacji microgateway_Version_OS_ARCH. Na przykład:
```
cd microgateway_2.5.26_Darwin_x86_64
```
Sprawdź katalog instalacji:
- /install/kubernetes – pliki konfiguracji .yaml do wdrożenia w Kubernetesie.
- /samples – przykładowe aplikacje do testowania instalacji.
- /bin – plik wykonywalny edgemicroctl. Polecenie edgemicroctlwstrzykuje Edge Microgateway do Kubernetes
Dodaj klienta edgemicroctl do PATH. Na przykład w systemie MacOS lub Linux uruchom to polecenie:
```
export PATH=$PWD/bin:$PATH
```
Zastosuj podstawową konfigurację Edge Microgateway do klastra Kubernetes. Poniższe polecenie tworzy przestrzeń nazw edgemicro-system i role klastra.
```
kubectl apply -f install/kubernetes/edgemicro.yaml
```
Zainstaluj kontroler Ingress NGINX w klastrze. Upewnij się, że żaden inny kontroler NGINX nie jest uruchomiony. Możesz to sprawdzić, uruchamiając polecenie kubectl get pods.
```
kubectl apply -f install/kubernetes/edgemicro-nginx-gke.yaml
```
Uwaga: kontroler ingress trzeba zainstalować tylko wtedy, gdy udostępniasz bramę Edge Microgateway użytkownikom spoza klastra. Jeśli chcesz udostępnić mikrobramę na zewnątrz, możesz użyć dowolnego kontrolera wejścia. NGINX jest tu używany tylko jako przykład.

Sprawdzanie instalacji

Aby sprawdzić, czy kontroler Ingress został uruchomiony, uruchom to polecenie:

kubectl get pods --all-namespaces -l app=edgemicro-ingress --watch

Jak widać na przykładowym wyjściu, uruchomienie procesów może potrwać minutę lub dwie. Normalnie występuje kilka cykli błędu i ponownego uruchamiania, zanim STATUS zmieni się na Running.

NAMESPACE          NAME                                            READY     STATUS             RESTARTS   AGE
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       CrashLoopBackOff   1          33s
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       Error              2          33s
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       CrashLoopBackOff   2          40s
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   0/1       Running            3          1m
edgemicro-system   edgemicro-ingress-controller-64444469bf-wjhrn   1/1       Running            3          1m

Gdy Ingress jest uruchomiony, możesz anulować powyższe polecenie, wpisując Ctrl+C.

Uruchom to polecenie, aby sprawdzić, czy usługi Kubernetes są wdrożone. Powinny wyświetlić się dane wyjściowe podobne do tych poniżej:

kubectl get svc -n edgemicro-system

Przykładowe dane wyjściowe:

NAME                        TYPE           CLUSTER-IP     EXTERNAL-IP    PORT(S)                     AGE
default-http-backend        ClusterIP      10.19.255.106  <none>         80/TCP                       2h
edgemicro-ingress           LoadBalancer   10.19.247.156  35.224.24.13   80:30176/TCP,443:32325/TCP   2h

Sprawdź, czy wszystkie pody są uruchomione:

kubectl get pods -n edgemicro-system

Przykładowe dane wyjściowe:

NAME                                            READY     STATUS    RESTARTS   AGE
default-http-backend-55c6c69b88-2lvtw           1/1       Running   0          4m
edgemicro-ingress-controller-64444469bf-wjhrn   1/1       Running   3          4m

Instalowanie Edge Microgateway

Musisz mieć zainstalowaną bramę Edge Microgateway w wersji 2.5.26 lub nowszej. Aby to sprawdzić, wpisz:
```
edgemicro --version
```
Jeśli nie masz zainstalowanej wersji Edge Microgateway 2.5.26 lub nowszej, uruchom skrypt instalacji:
```
npm install edgemicro -g
```
Jeśli Edge Microgateway został dopiero co zainstalowany lub uaktualniony, uruchom to polecenie:
```
edgemicro init
```
Jeśli potrzebujesz dodatkowej pomocy, zapoznaj się z artykułem Instalowanie urządzenia Edge Microgateway.

Następny krok

Możesz teraz wdrożyć Edge Microgateway w Kubernetes.

Zobacz Wdrożenie Edge Microgateway jako usługi.