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

Wymagania wstępne integracji Kubernetes

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

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

Tematy w tej sekcji to:

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

Wymagania klastra Kubernetes

Twój 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, po 2 procesory wirtualne każdy.

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

Konfigurowanie maszyny administracyjnej Kubernetes

Maszyna administracyjna Kubernetes to komputer lokalny, którego używasz do uruchamiania poleceń klastra Kubernetes. Jest to zwykle komputer stacjonarny, który ma dostęp do maszyn wirtualnych Kubernetes.

Na komputerze administracyjnym Kubernetes musisz zainstalować te narzędzia:

Zainstaluj interfejs wiersza poleceń kubectl w wersji 1.9 lub nowszej.
(Tylko GKE) Zainstaluj gcloud, jeśli korzystasz z Kubernetes w GKE.

Tworzenie klastra Kubernetes w GKE

Zaloguj się w panelu Google Kubernetes Engine (GKE) w Google Cloud Platform (GCP).
Kliknij Utwórz klaster.
Wybierz Klaster standardowy.
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.

Zrzut ekranu poniżej przedstawia panel GKE wypełniony zgodnie z opisem w poprzednich krokach:

Uzyskaj dane 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 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 poniższe polecenie w sposób pokazany poniżej. To polecenie przyznaje obecnemu użytkownikowi uprawnienia administratora klastra. Do tworzenia niezbędnych reguł RBAC dla usługi Edge Microgateway wymagane są uprawnienia administratora:
```
kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=$(gcloud config get-value core/account)
```

Instalowanie Edge Microgateway dla Kubernetes

Pobierz Edge Microgateway dla Kubernetes. Jeśli korzystasz z komputera z systemem macOS lub Linux, możesz pobrać najnowszą 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ę według numeru. Pamiętaj, że numer wersji musi być poprzedzony literą „v”. Na przykład: wersja 3.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 instalacyjny microgateway_Version_OS_ARCH. Na przykład:
```
cd microgateway_2.5.26_Darwin_x86_64
```
Sprawdź katalog instalacji:
- /install/kubernetes – pliki konfiguracji .yaml na potrzeby wdrożenia w Kubernetes.
- /samples – przykładowe aplikacje do testowania instalacji.
- /bin – plik wykonywalny edgemicroctl. Polecenie edgemicroctl wprowadza do Kubernetes instancję Edge Microgateway
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 w klastrze.
```
kubectl apply -f install/kubernetes/edgemicro.yaml
```
Zainstaluj kontroler ruchu przychodzącego NGINX w klastrze. Upewnij się, że żaden inny kontroler Nginix nie jest uruchomiony. Możesz to sprawdzić, uruchamiając polecenie kubectl get pods.
```
kubectl apply -f install/kubernetes/edgemicro-nginx-gke.yaml
```
Uwaga: kontroler ruchu przychodzącego musisz zainstalować tylko wtedy, gdy udostępniasz Edge Microgateway klientom spoza klastra. Jeśli udostępniasz mikrobramę na zewnątrz, możesz użyć dowolnego kontrolera ruchu przychodzącego. W tym przykładzie użyto NGINX tylko jako przykładu.

Zweryfikuj instalację

Aby sprawdzić, czy kontroler ruchu przychodzącego został uruchomiony, uruchom to polecenie:

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

Jak widać na przykładzie poniżej, uruchomienie procesów może potrwać minutę lub dwie. Zanim STATUS zmieni się na Running, może pojawić się kilka cykli błędów i ponownego uruchomienia.

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

Po uruchomieniu obiektu Ingress możesz anulować to polecenie, wpisując Ctrl+C.

Uruchom to polecenie, aby sprawdzić, czy usługi Kubernetes są wdrożone. Powinny się wyświetlić 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

Zainstaluj Edge Microgateway

Musisz mieć zainstalowaną wersję Edge Microgateway 2.5.26 lub nowszą. Możesz to sprawdzić, wpisując:
```
edgemicro --version
```
Jeśli nie masz zainstalowanej przeglądarki Edge Microgateway w wersji 2.5.26 lub nowszej, wykonaj skrypt instalacyjny:
```
npm install edgemicro -g
```
Jeśli Edge Microgateway została zainstalowana po raz pierwszy lub uaktualniona, uruchom to polecenie:
```
edgemicro init
```
Jeśli potrzebujesz dodatkowej pomocy, zobacz Instalowanie Edge Microgateway.

Następny krok

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

Zobacz artykuł o wdrażaniu Edge Microgateway jako usługi.