Bu sayfa, Cloud Translation API ile çevrilmiştir.

Edge Microgateway'i yardımcı dosya proxy'si olarak dağıtma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info

DESTEKLENMİYOR: Edge Microgateway'i, Kubernetes'te yan araç proxy kalıbı kullanılarak çalıştırmak desteklenir. Ancak bu konuda açıklanan edgemicroctl ve ilgili araç desteği sonlandırılmıştır. Bu araç, artık desteklenmeyen Istio yan araç enjektörünü kullanır.

Giriş

Bu konuda, Edge Microgateway'in Kubernetes kümesinde yan araç proxy'si olarak nasıl çalıştırılacağı açıklanmaktadır. Yan araç dağıtımı için iki seçeneğiniz vardır: manuel ve otomatik ekleme. Bu konuda her iki seçenek de açıklanmaktadır.

Daha fazla bilgi için Kubernetes'te Edge Microgateway'e Giriş başlıklı makaleyi inceleyin.

Başlamadan önce

Ön koşullar bölümünde açıklanan adımları tamamlayın.

Test hizmeti dağıtma

Basit bir "merhaba" hizmeti dağıtın ve dağıtımı doğrulayın:

Örneği dağıtın:

kubectl apply -f samples/helloworld/helloworld.yaml --namespace=default

Hizmetin çalıştığını doğrulayın. Kapsülün çalışan duruma gelmesi için birkaç dakika beklemeniz gerekebilir:
```
kubectl get pods --namespace=default
```
Örnek çıkış:
```
NAME                          READY     STATUS    RESTARTS   AGE
helloworld-569d6565f9-lwrrv   1/1       Running   0          17m
```
Not: 1/1 olan HAZIR durumunun, kapsülün içinde "bir taneden biri" hizmetin çalıştığı anlamına geldiğini unutmayın. Aşağıdaki adımlarda, Edge Microgateway'ın oluşturduğunuz tüm yeni kapsüllere otomatik olarak bir yan araç olarak enjekte edilmesi için kümeyi yapılandıracaksınız. Bu durumda, kubectl get pods komutunu çalıştırdığınızda kapsülün içinde "ikiden iki" hizmetin (hizmet ve yardımcı program) çalıştığını görürsünüz.
Test hizmeti dağıtımını silin. Yan araç eklemeyi etkinleştirdikten sonra daha sonra yeniden yüklersiniz:
```
 kubectl delete -f samples/helloworld/helloworld.yaml --namespace=default
```

Manuel yardımcı program enjeksiyonunu kullanma

İki yan araç enjeksiyon seçeneğinden manuel yan araç enjeksiyonu daha basit ve daha kolay bir yaklaşımdır ve tek bir kubectl komutuyla yapılabilir.

Edge mikro ağ geçidini yapılandırma

Aşağıdaki komut, Edge Microgateway'i Apigee kuruluşunuz için yapılandırır ve edgemicro-auth proxy'sini dağıtır.

Aşağıdaki komutu çalıştırın:

edgemicro configure -o [org] -e [env] -u [username]

Burada:

org: Edge kuruluş adınız (kuruluş yöneticisi olmanız gerekir).
env: Kuruluşunuzdaki bir ortam (test veya prod gibi).
username: Apigee hesabınızla ilişkili e-posta adresi.

Örnek

edgemicro configure -o myorg -e test -u jdoe@example.com

Çıkış (aşağıda gösterilen örnek) dosyaya kaydedilir:

$HOME/.edgemicro/org_name-env_name-config.yaml

current nodejs version is v6.9.1
current edgemicro version is 2.5.25
password:
file doesn't exist, setting up
Give me a minute or two... this can take a while...
App edgemicro-auth deployed.
checking org for existing KVM
KVM already exists in your org
configuring host edgemicroservices.apigee.net for region us-west1

saving configuration information to: /Users/jdoe/.edgemicro/myorg-test-config.yaml

vault info:
 -----BEGIN CERTIFICATE-----
MIICpDCCAYwCCQCV9eBcO9a5WzANBgkqhkiG9w0BAQsFADAUMRIwEAYDVQQDDAls
b2NhbGhvc3QwHhcNMagwODA5MDAzMDEzWhcNMTgwODEwMDAzMDEzWjAUMRIwEAYD
VQQDDBlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDh
nAHT7JHX/WvWHRFb8FLm53SPIDld5LyPOUfINdEyhSIEeXoOUKg4EPweJPVSC9Vm
Hw4ZMtEqWJM/XsQWvLe8ylRJa5wgmzmFCqAsuzs9+rmc9KvJqjpOh2uRTUf7KKfT
iXL2UEseprcI5g8zNyqKyEf/ecWIwz3AkkPAZebVTsrdDfIDHvkyhhvlAHZAB9kn
GtqP3N8kOlv4KQto9Gr7GYUGUIDugt7gM1F611+RBS+fYRi32GUAq/UQDkhYL8cp
oIJiF7UYkk2+9t9CdOCDuIUCvJioHJQd0xvDpkC9f6LvwjwnCwku+4F2Q63+av5I
mJoZJQPvW5aP53Qkk+kHAgMBAAEwDKYJKoZIhvcNAQELBQADggEBALyUBolXUFN8
1bf268nR+gS8MOFDTxO1bUz+bKuT/g3K1PuNUJTueT+0L1H2OiZUzazAqwn2sqzN
lQuvLg6LjxjlNkqTJGiJvGDcYVq45dv7UyxAZxhqxTxhlQ+Yu5R9pbQnzujezHpH
6gtCoCkSt/QqiJ3YsmsVu5is+HpIJepMt0CyMh5tK9j87hl46QhHklaVfQ3ycMVm
/wNPR/pjizg1FDUeq4nj/7DBVbMf9net/BDaZLeSW1HJ1vcsCXIcSZfQd4QymGFn
8ADrND7ydVjwO/s23soPDTy0g4yLIZvky2tpT8d7YahNqSv2n7sXsLxruzcyCoQ4
w+e3Z3F7IKI=
-----END CERTIFICATE-----

The following credentials are required to start edge micro
  key: 1a3b2754c7f20614817b86e09895825ecc252d34df6c4be21ae24356f09e6eb4
  secret: 16ad2431de73f07f57a6d44048f08d93b63f783bf1f2ac4221182aa7289c7cef

edgemicro configuration complete!

Edge Microgateway'i yardımcı olarak ekleme

Edge Microgateway'i bir hizmet kapsülüne yan araç proxy'si olarak manuel olarak eklemek için aşağıdaki komutu yürütün:

kubectl apply -f <(edgemicroctl -org=your_org -env=your_env -key=your_key -sec=your_secret -conf=config_file_path -svc=service_deployment_file)

Bu örnekte:

your_org: edgemicro configure komutunda belirttiğiniz Apigee kuruluşu.
your_env: edgemicro configure komutunda belirttiğiniz ortam.
your_key: edgemicro configure komutundan döndürülen anahtar.
your_secret: edgemicro configure komutundan döndürülen gizli anahtar.
config_file_path: edgemicro configure komutundan döndürülen Edge Micro yapılandırma dosyasının yolu.
service_deployment_file: Pod'u tamamlayıcı yan hizmetini alacak hizmetin dağıtım dosyasının yolu. Örneğin: samples/helloworld/helloworld.yaml.

Örneğin:

kubectl apply -f <(edgemicroctl -org=myorg -env=test-key=0e3ecea28a64099410594406b30e54439af5265f8 -sec=e3919250bee37c69cb2e5b41170b488e1c1d -conf=/Users/jdoe/.edgemicro/myorg-test-config.yaml -svc=samples/helloworld/helloworld.yaml)

Yapılandırmayı test etme

Hizmet dağıtımlarını kontrol edin:

kubectl get services -n default

Örnek çıkış:

NAME         TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
helloworld   NodePort    10.15.254.163   <none>        8081:32401/TCP   56s
kubernetes   ClusterIP   10.15.240.1     <none>        443/TCP          41m

Artık Edge Microgateway'in yardımcı program dağıtımını test etmeye hazırsınız. Ayrıntılı adımlar için Proxy'yi test etme başlıklı makaleyi inceleyin.

Otomatik yan kapsül ekleme özelliğini kullanma

Aşağıdaki adımlarda, Kubernetes kümeniz için otomatik yan kapsül eklemeyi yapılandıracaksınız. Bu kurulum, Edge Microgateway'in Kubernetes'e yardımcı proxy olarak eklenmesine olanak tanır.

Yardımcı dosya enjektörünü yükleme

Edge mikro ağ geçidinin yardımcı program enjeksiyonunu etkinleştiren ConfigMap'i yükleyin:
```
kubectl apply -f install/kubernetes/edgemicro-sidecar-injector-configmap-release.yaml
```
Webhook hizmetini yüklemek için aşağıdaki komut dosyasını çalıştırın. Otomatik yan araç ekleme için webhook hizmeti gereklidir:

Not: Webhook hizmeti için imzalanmış bir sertifika/anahtar çifti gerekir. Aşağıdaki komut dosyası, Kubernetes Sertifika Yetkilisi (CA) tarafından imzalanmış bir sertifika/anahtar çifti oluşturur. Elde edilen sertifika/anahtar dosyası, yan bölme enjektör webhook'unun kullanması için Kubernetes gizlisi olarak depolanır. Kubernetes CA onayı için sertifika imzalama isteğini (CSR) oluşturma ve onaylama izinleri gerekir. Daha fazla bilgi için Bir kümede tls'yi yönetme başlıklı makaleyi inceleyin ve install/kubernetes/webhook-create-signed-cert.sh komut dosyasını inceleyin.
```
./install/kubernetes/webhook-create-signed-cert.sh \
    --service edgemicro-sidecar-injector \
    --namespace edgemicro-system \
    --secret sidecar-injector-certs
```

CA paketini webhook yükleme dosyasına ekleyin. Kubernetes api-server, webhook'ı çağırmak için şu dosyayı kullanır:

cat install/kubernetes/edgemicro-sidecar-injector.yaml | \
     ./install/kubernetes/webhook-patch-ca-bundle.sh > \
     install/kubernetes/edgemicro-sidecar-injector-with-ca-bundle.yaml

Edge Microgateway yardımcı dosya enjektör webhook'unu yükleyin:

kubectl apply -f install/kubernetes/edgemicro-sidecar-injector-with-ca-bundle.yaml

Örnek çıkış:

service "edgemicro-sidecar-injector" created
serviceaccount "edgemicro-sidecar-injector-service-account" created
deployment "edgemicro-sidecar-injector" created
mutatingwebhookconfiguration "edgemicro-sidecar-injector" created

Edge Microgateway yan araç enjektör webhook'unun çalıştığını doğrulayın:

kubectl -n edgemicro-system get deployment -ledgemicro=sidecar-injector

Örnek çıkış:

NAME                         DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
edgemicro-sidecar-injector   1         1         1            1           12m

Yan kapsül enjeksiyon kapsülünün kümenizde çalıştığını doğrulayın. edgemicro-system ad alanının içinde; giriş denetleyicisi, varsayılan HTTP arka ucu ve yan araç enjektörü dahil olmak üzere sistem hizmetleri yüklenir:

kubectl get pods -n edgemicro-system

Örnek çıkış:

NAME                                            READY     STATUS    RESTARTS   AGE
default-http-backend-55c6c69b88-gfnfd           1/1       Running   0          1h
edgemicro-ingress-controller-64444469bf-jhn8b   1/1       Running   3          1h
edgemicro-sidecar-injector-7d95698fbf-cq84q     1/1       Running   0          3m

Edge Microgateway'i yapılandırma ve ekleme

Sonraki adımda, Kubernetes ad alanını içeren bir Edge Microgateway yapılandırması oluşturmak için etkileşimli bir komut dosyası çalıştıracaksınız. Ardından, yapılandırmayı Kubernetes kümenize eklersiniz.

Aşağıdaki etkileşimli komut dosyasını çalıştırın ve istenen parametreleri sağlayın. Komut, sonraki adımda kullanacağınız bir yapılandırma profili oluşturur.
```
./install/kubernetes/webhook-edgemicro-patch.sh
```
Giriş parametreleri hakkında bilgi edinmek için Referans bölümüne bakın.

Örnek girişler:
1. Namespace to deploy application [default]:
  
  Enter tuşuna basın.
2. Authenticate with OAuth Token ("n","Y") [N/y]
  
  n değerini girin.
3. Apigee username [required]:
  
  Apigee kullanıcı adınızı (e-posta adresiniz) girin. Örneğin: jdoe@google.com.
4. Apigee password [required]:
  
  Apigee şifrenizi girin.
5. Apigee organization [required]:
  
  Apigee kuruluş adınızı girin.
6. Apigee environment [required]:
  
  Kuruluşunuz için bir ortam adı girin. Örneğin "test".
7. Virtual Host [default]:
  
  Enter tuşuna basın.
8. Is this Private Cloud ("n","y") [N/y]:
  
  Public Cloud kullanıyorsanız n yazın.
9. Edgemicro Key. Press Enter to generate:
  
  Enter tuşuna basın.
10. Edgemicro Secret. Press Enter to generate:
  
  Enter tuşuna basın.
11. Edgemicro org-env-config.yaml. Press Enter to generate:
  
  Enter tuşuna basın.
  
  Örnek çıkış:
```
current nodejs version is v6.9.1
current edgemicro version is 2.5.25
config initialized to /Users/jdoe/.edgemicro/default.yaml
Configure for Cloud
******************************************************************************************
Config file is Generated in /Users/jdoe/Work/GITHUB/microgateway_2.5.25_Darwin_x86_64/config directory.

Please make changes as desired.
*****************************************************************************************
```
12. Do you agree to proceed("n","y") [N/y]:
  
  y yazın.
  
  Örnek çıkış:
```
Configuring Microgateway with

key:daacf75dd660d160b801c9117fb1ec0935896615479e39dbbae88be81a2d84
secret:a60fd57c1db9f3a06648173fb541cb9c59188d3b6037a76f490ebf7a6584b0
config:~/.edgemicro/jdoe-test-config.yaml

********************************************************************************************************
kubectl apply -f install/kubernetes/edgemicro-config-namespace-bundle.yaml
********************************************************************************************************
```
Not: Etkileşimli olmayan kullanım için komut dosyasına parametreler de iletebilirsiniz. Ayrıntılar için ./install/kubernetes/webhook-edgemicro-patch.sh bölümündeki yorumlara bakın.
Çıktının son satırında verilen komutu yürütün. Bu kubectl komutu, oluşturulan Edge Microgateway yapılandırma profilini Kubernetes'e ekler:
```
kubectl apply -f install/kubernetes/edgemicro-config-namespace-bundle.yaml
```

Webhook eklemenin durumunu görüntüleyin. Bu özelliğin şu anda etkin olmadığını unutmayın:

kubectl get namespace -L edgemicro-injection

Örnek çıkış:

NAME               STATUS    AGE       EDGEMICRO-INJECTION
default            Active    1d
edgemicro-system   Active    1d
kube-public        Active    1d
kube-system        Active    1d

Webhook için webhook eklemeyi etkinleştirmek üzere şu komutu çalıştırın:
```
kubectl label namespace default edgemicro-injection=enabled
```

Webhook eklemenin durumunu tekrar görüntüleyin. Artık etkin olduğunu unutmayın:

kubectl get namespace -L edgemicro-injection

Örnek çıkış:

NAME               STATUS    AGE       EDGEMICRO-INJECTION
default            Active    1d        enabled
edgemicro-system   Active    1d
kube-public        Active    1d
kube-system        Active    1d

Test hizmetini dağıtma

Ardından test hizmetini yeniden dağıtın. Edge Microgateway, hizmetin kapsülüne otomatik olarak eklenir.

kubectl apply -f samples/helloworld/helloworld.yaml --namespace=default

Edge Microgateway'in test hizmetiyle birlikte kapsüle enjekte edildiğini doğrulayın:

kubectl get pods --namespace=default --watch

Örnek çıkış:

NAME                          READY     STATUS            RESTARTS   AGE
helloworld-6987878fc4-pkw8h   0/2       PodInitializing   0          12s
helloworld-6987878fc4-pkw8h   2/2       Running           0         26s

Durum Running olarak değiştiğinde, komuttan çıkmak için ctrl-c'a basın.

Artık Edge Microgateway'in otomatik yan araç dağıtımını test etmeye hazırsınız. Ayrıntılı adımlar için Proxy'yi test etme başlıklı makaleyi inceleyin.

Proxy'yi test etme

Yan araç dağıtımıyla, hizmetiniz için otomatik olarak bir API proxy'si oluşturulur. "Edge Microgateway farkında" bir proxy oluşturmanız gerekmez.

Giriş IP adresini alma

Giriş için harici IP ile hizmeti kümenin dışından çağırabilirsiniz.

Giriş denetleyicisinin harici IP adresini alın:

kubectl get ing -o wide

Örnek çıkış:

NAME      HOSTS     ADDRESS        PORTS     AGE
gateway   *         35.238.13.54   80        1m

Ingress için EXTERNAL-IP değerini kopyalayıp bir değişkene aktarın. Değişkeni manuel olarak ayarlayabilirsiniz:
```
export GATEWAY_IP=external_ip
```
Örneğin:
```
export GATEWAY_IP=35.238.249.62
```
Dilerseniz bu komutu kullanarak ayarlama işlemini sizin yerinize yapmasını sağlayabilirsiniz:
```
export GATEWAY_IP=$(kubectl describe ing gateway --namespace default | grep "Address" | cut -d ':' -f2 | tr -d "[:space:]")
```
Değişkenin dışa aktarıldığını doğrulayın. Örneğin:
```
echo $GATEWAY_IP
```
Örnek çıkış:
```
35.238.249.62
```
Hizmeti arayın:
```
curl $GATEWAY_IP
```
Çıkış:
```
{"error":"missing_authorization","error_description":"Missing Authorization header"}
```
Ardından, geçerli bir API anahtarı alabilmeniz için Edge'de bir API ürünü ve geliştirici uygulaması yapılandırarak eksik yetkilendirme hatasını giderirsiniz. Anahtarı API çağrısı için bir yetkilendirme başlığına eklediğinizde çağrı başarılı olur ve bu hatayı görmezsiniz.

Apigee Edge'de bileşen oluşturma

Ardından Apigee Edge'de bir API ürünü ve geliştirici uygulaması oluşturun.

API ürünü oluşturma

Apigee Edge'e giriş yapın.
Yan gezinme menüsünde Yayınla > API Ürünleri'ni seçin.
+ API Ürünü'nü tıklayın. Ürün sayfası gösterilir.
Ürün sayfasını aşağıdaki gibi doldurun. Aşağıda bahsedilmeyen alanlar için varsayılan değerleri kullanabilirsiniz. Talimat verilmeden kaydetmeyin.

Ad hello-world-product

Görünen Ad Edge Micro hello product

Ortam test
Yol bölümünde + Özel Kaynak'ı tıklayın.
/ yolunu ekleyin.
Tekrar + Özel Kaynak'ı tıklayın ve /** yolunu ekleyin.
API Proxy'leri bölümünde + API Proxy'yi tıklayın ve edgemicro-auth'u ekleyin.
API Ürünü'nü kaydedin.

Geliştirici Uygulaması Oluşturma

Yan gezinme menüsünde Uygulamalar'ı seçin.
+ Uygulama'yı tıklayın. Geliştirici Uygulama Ayrıntıları sayfası gösterilir.
Geliştirici uygulaması sayfasını aşağıdaki gibi doldurun. Talimat verilinceye kadar kaydetmeyin.

Ad hello-world-app

Görünen Ad Edge Micro hello app

Developer Açılır menüden bir geliştirici seçin.
Kimlik Bilgileri bölümünde + Ürün'ü tıklayın ve yeni oluşturduğunuz hello-world-product seçeneğini belirleyin.
Kaydet'i tıklayın.
Tüm geliştirici uygulamalarının listelendiği sayfaya geri dönersiniz.
Yeni oluşturduğunuz uygulamayı hello-world-app seçin.
Tüketici Anahtarı'nın yanındaki Göster'i tıklayın.
Tüketici anahtarının değerini kopyalayın. Bu değer, helloworld hizmetine güvenli API çağrıları yapmak için kullanacağınız API anahtarıdır.
Birkaç dakika bekleyin. Apigee Edge'de yaptığınız değişikliklerin, kümede dağıtılan Edge Microgateway örneğiyle senkronize edilmesi birkaç dakika sürer.

Not: Edge Microgateway, Apigee Edge'de yapılan değişiklikleri 600 saniyede bir (varsayılan olarak) sorar ve proxy'lerde, API ürünlerinde ve geliştirici uygulamalarında yapılan tüm yapılandırma değişikliklerini alır. Edge Microgateway yapılandırma dosyasını düzenleyerek varsayılan 600 saniyelik süreyi değiştirebilirsiniz. Ayrıntılar için Edge Microgateway dokümanlarına bakın.

API'yi çağırma

Yapılandırma değişiklikleri mikro geçiş noktasına çekildikten sonra aşağıdaki testleri yapabilirsiniz.

API'yi API anahtarı olmadan çağırabilirsiniz. Aşağıda gösterilen hata mesajını alırsınız:
```
curl $GATEWAY_IP
```
Beklenen çıkış:
```
{"error":"missing_authorization","error_description":"Missing Authorization
header"}
```
Başarılı API çağrıları yapmak için API anahtarına ihtiyacınız vardır.
Oluşturduğunuz Geliştirici uygulamasından tüketici anahtarını alın. Bu değer, test proxy'sini çağırmak için ihtiyacınız olan API anahtarıdır:
```
curl -H 'x-api-key:your-edge-api-key'  $GATEWAY_IP
```
Örneğin:
```
curl -H "x-api-key:DeX2eEesYAdRJ5Gdbo77nT9uUfJZql19" $GATEWAY_IP
```
Çıkış:
```
Hello world
```
"Merhaba dünya" yanıtı, kapsüle dağıtılan helloworld hizmeti tarafından döndürülür. Bu hizmete yapılan çağrı, kimlik doğrulamanın yapıldığı Edge Microgateway'den geçti. "Merhaba dünya" yanıtını görüyorsanız Edge Microgateway'i helloworld hizmet kapsülünde yardımcı proxy olarak çalışacak şekilde başarıyla yapılandırmışsınız demektir.

Sırada ne var?

Özel eklentiler ekleme, dağıtımı ölçeklendirme, yapılandırma değişiklikleri yapma ve gerçekleştirmek isteyebileceğiniz diğer görevler hakkında bilgi edinmek için Görevler bölümüne bakın.

Ad	`hello-world-product`
Görünen Ad	`Edge Micro hello product`
Ortam	`test`

Ad	`hello-world-app`
Görünen Ad	`Edge Micro hello app`
Developer	Açılır menüden bir geliştirici seçin.