‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

پیش‌نیازهای یکپارچه‌سازی Kubernetes

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

این موضوع مراحل لازم برای تکمیل قبل‌از نصب Edge Microgateway به‌عنوان خدمات در خوشه Kubernetes را توضیح می‌دهد.

این موضوع درباره موارد زیر بحث می‌کند:

حداقل پیش‌نیازهای لازم برای خوشه Kubernetes شما.
نحوه نصب و پیکربندی Edge Microgateway.
نحوه نصب پیکربندی پایه Edge Microgateway در خوشه Kubernetes.

مراجعه کنید.

الزامات برای خوشه Kubernetes

خوشه Kubernetes شما به این موارد نیاز دارد:

‫Kubernetes نسخه ۱.۹ یا بالاتر.
‫Kubernetes CLI kubectl نسخه ۱.۹ یا بالاتر.
خوشه‌ای با حداقل ۳ گره که هرکدام ۲ vCPU داشته باشند.

مثال: ایجاد خوشه Kubernetes در Google Kubernetes Engine‏ (GKE)

راه‌اندازی ماشین مدیریت Kubernetes

دستگاه مدیریت Kubernetes دستگاه محلی شما است که از آن برای اجرای فرمان‌ها دربرابر خوشه Kubernetes خود استفاده می‌کنید. این ماشین معمولاً ماشین رایانه‌ای است که به ماشین‌های مجازی Kubernetes شما دسترسی دارد.

باید ابزارهای زیر را در ماشین مدیریت Kubernetes نصب کنید:

واسط خط فرمان kubectl نسخه ۱.۹ یا جدیدتر را نصب کنید.
(فقط GKE) اگر Kubernetes را در GKE اجرا می‌کنید، gcloud را نصب کنید.

ایجاد خوشه Kubernetes در GKE

در Google Cloud Platform (GCP) به داشبورد Google Kubernetes Engine (GKE) وارد شوید.
روی ایجاد خوشه کلیک کنید.
خوشه استاندارد را انتخاب کنید.
نامی برای خوشه‌تان وارد کنید.
«منطقه‌ای» را انتخاب کنید.
Cluster Version 1.9.7-gke-* را انتخاب کنید. برای مثال 1.9.7-gke.6.
اندازه ۳ گره را انتخاب کنید.
‫۲ vCPU با ۷٫۵ گیگابایت حافظه را انتخاب کنید.
روی ایجاد کردن کلیک کنید.

نماگرفت زیر داشبورد GKE را نشان می‌دهد که طبق آنچه در مراحل قبلی توضیح داده شد تکمیل شده است:

دریافت اعتبارنامه‌های خوشه

نام پروژه GKE خود را تنظیم کنید:
```
gcloud config set project projectName
```
منطقه پروژه GKE خود را تنظیم کنید:
```
gcloud config set compute/zone zoneName
```
اطلاعات اعتباری gcloud container خود را دریافت کنید:
```
gcloud container clusters get-credentials cluster-name --zone zone --project project-name
```
کجا:
- ‫cluster-name نام خوشه Kubernetes است که ایجاد کرده‌اید.
- ‫zone منطقه‌ای است که خوشه‌تان در آن قرار دارد.
- ‫project-name نام پروژه GCP شما است.
برای مثال:
```
gcloud container clusters get-credentials edgemicrogateway-cluster --zone us-central1-a --project edgemicro-project
```
فرمان زیر را دقیقاً همان‌گونه که نشان داده شده است اجرا کنید. این فرمان اجازه‌های سرپرست خوشه را به کاربر کنونی اعطا می‌کند. برای ایجاد قوانین RBAC لازم برای سرویس Edge Microgateway، اجازه‌های سرپرست لازم است:
```
kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=$(gcloud config get-value core/account)
```

نصب Edge Microgateway برای Kubernetes

‫Edge Microgateway را برای Kubernetes بارگیری کنید. اگر از دستگاه MacOS یا Linux استفاده می‌کنید، می‌توانید با مشخص کردن نام نسخه، جدیدترین نسخه یا نسخه خاصی را بارگیری کنید.

برای دریافت جدیدترین نسخه:
```
curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -
```
برای دریافت نسخه خاص براساس شماره نسخه. توجه داشته باشید که شماره نسخه باید با حرف «v» شروع شود. برای مثال: v3.0.2
```
curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s  version
```
برای مثال:
```
curl -L https://raw.githubusercontent.com/apigee-internal/microgateway/master/kubernetes/release/downloadEdgeMicrok8s.sh | sh -s v3.0.2
```
دایرکتوری را به دایرکتوری نصب microgateway_Version_OS_ARCH تغییر دهید. برای مثال:
```
cd microgateway_2.5.26_Darwin_x86_64
```
پوشه نصب را بررسی کنید:
- ‫/install/kubernetes - پیکربندی .yaml فایل برای استقرار در Kubernetes.
- ‫/samples - برنامه‌های نمونه برای آزمایش نصب.
- ‫/bin - فایل اجرایی edgemicroctl. فرمان edgemicroctl ‫Edge Microgateway را به Kubernetes تزریق می‌کند
کارخواه edgemicroctl را به PATH خود اضافه کنید. برای مثال، فرمان زیر را در سیستم MacOS یا Linux اجرا کنید:
```
export PATH=$PWD/bin:$PATH
```
راه‌اندازی پایه Edge Microgateway را در خوشه Kubernetes اعمال کنید. فرمان زیر فضای نام edgemicro-system و نقش‌های خوشه ایجاد می‌کند.
```
kubectl apply -f install/kubernetes/edgemicro.yaml
```
کنترل‌کننده NGINX Ingress را در خوشه نصب کنید. مطمئن شوید که هیچ کنترل‌کننده Nginix دیگری درحال اجرا نباشد. با اجرای kubectl get pods می‌توانید بررسی کنید.
```
kubectl apply -f install/kubernetes/edgemicro-nginx-gke.yaml
```
توجه: فقط درصورتی باید کنترل‌کننده ورودی نصب کنید که Edge Microgateway را برای مصرف‌کنندگان خارج از خوشه نمایان می‌کنید. اگر ریزدروازه را به‌صورت خارجی درمعرض دید قرار می‌دهید، می‌توانید از هر کنترل‌کننده ورودی‌ای که می‌خواهید استفاده کنید. ‫NGINX فقط به‌عنوان نمونه در اینجا استفاده شده است.

به‌تأیید رساندن نصب

برای بررسی اینکه کنترل‌کننده Ingress شروع شده است یا نه، فرمان زیر را اجرا کنید:

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

همان‌طور که برونداد نمونه زیر نشان می‌دهد، یک یا دو دقیقه طول می‌کشد تا فرایندها شروع شوند. طبیعی است که قبل‌از اینکه STATUS به 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

پس‌از اجرای Ingress، می‌توانید با تایپ کردن Ctrl+C، فرمان بالا را لغو کنید.

برای بررسی اینکه سرویس‌های Kubernetes مستقر شده‌اند، این فرمان را اجرا کنید. باید بروندادی مشابه برونداد نمونه نشان‌داده‌شده در زیر ببینید:

kubectl get svc -n edgemicro-system

برونداد نمونه:

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

درستی‌سنجی کنید که همه غلاف‌ها درحال اجرا باشند:

kubectl get pods -n edgemicro-system

برونداد نمونه:

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

نصب Edge Microgateway

باید Edge Microgateway 2.5.26 یا نسخه جدیدتری نصب کرده باشید. با وارد کردن موارد زیر می‌توانید بررسی کنید:
```
edgemicro --version
```
اگر Edge Microgateway نسخه ۲.۵.۲۶ یا جدیدتر را نصب نکرده‌اید، نوشتار نصب را اجرا کنید:
```
npm install edgemicro -g
```
اگر Edge Microgateway را به‌تازگی برای اولین‌بار نصب کرده‌اید یا آن را ارتقا داده‌اید، این فرمان را اجرا کنید:
```
edgemicro init
```
اگر به راهنمایی بیشتری نیاز دارید، نصب Edge Microgateway را ببینید.

مرحله بعدی

اکنون آماده‌اید Edge Microgateway را در Kubernetes مستقر کنید.

استقرار Edge Microgateway به‌عنوان سرویس را ببینید.