Apigee Edge'de Node.js'yi kullanmaya başlama

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

Bu konuda, yönetim kullanıcı arayüzünü kullanarak Node.js uygulamasını API proxy'sinde sarmalamanın en basit yolu açıklanmaktadır.

Giriş

Muhtemelen oluşturduğunuz ilk Node.js uygulaması, isteklere "Merhaba Dünya!" mesajıyla yanıt veren bir HTTP sunucusudur. Apigee Edge'de Node.js'yi denemenin en basit yolu buna çok benzer bir işlem yapmaktır. Yalnızca birkaç tıklamayla Edge'de çalışan ve proxy üzerinden çalışan bir Node.js HTTP sunucusuna sahip olursunuz. Sonrasında, Node.js uygulamasını değiştirmek, ve daha fazla Node.js dosyası eklemek, politika eklemek için kullanıcı arayüzündeki kod düzenleyiciyi kullanabilirsiniz.

Örnek Hello World! API proxy'si

Bu bölümde, Node.js HTTP sunucusuyla etkileşim kuran bir Edge API proxy'sinin nasıl oluşturulacağı açıklanmaktadır. Node.js HTTP sunucu kodu sizin için önceden yazılmıştır ve bu basit adımları uyguladığınızda otomatik olarak Edge'e dağıtılır.
  1. Proxy Oluşturma sihirbazında, Node.js Uygulaması'nı seçin.
  2. İleri'yi tıklayın.
  3. Proxy Oluştur sihirbazını izleyin ve aşağıdaki seçimleri yapın.
    Alan Seçim
    Ayrıntılar
    Proxy Adı Nodejs-Hello girin. API'niz için görüntülenen ad.
    Proxy Temel Yolu Nodejs-hello komutunu girin.
    Kaynak "Hello World" Sample'ı (Merhaba Dünya Örneği) seçin. (Diğer seçenekleri, bu konunun ilerleyen bölümlerinde ele alacağız.)
    Açıklama API için bir açıklama girin.
    Security
    Geçiş (hiçbiri) Geçiş (yok) seçeneğini belirleyin. Basit bir proxy üzerinden geçiş oluşturur.
    Sanal Ana Makineler
    varsayılan, güvenli Varsayılanları değiştirmeyin. Sanal ana makineler hakkında bilgi edinmek için Sanal ana makineler hakkında (Beta) başlıklı makaleyi inceleyin.
    Oluşturma
    Ortamları Dağıtma Test'i seçin.
  4. Derleme ve Dağıt'ı tıklayın
    Buna yanıt olarak, yeni API proxy'nizin "test" ortamında başarıyla oluşturulduğuna ve dağıtıldığına dair bir onay mesajı görürsünüz.
  5. API proxy'sinin ayrıntılar sayfasını görüntülemek için Düzenleyicide <proxy adı> proxy'sini göster'i tıklayın.

hello proxy'si çağrılıyor

hello proxy'sini çağırdığınızda Node.js uygulaması otomatik olarak "Merhaba Dünya!" mesajıyla yanıt verir. Aksi belirtilmedikçe, Node.js uygulamasının test adlı ortama dağıtılacağını unutmayın. Burada, Curl'nin kullanıldığı temel çağrıyı görebilirsiniz (kuruluş adınızı myorg ile değiştirin).
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

Node.js kodunu görüntüleme ve düzenleme

API proxy'sine eklenen Node.js koduna bakalım. Hello World proxy'sinin özet sayfasına gidin ve Geliştir'i tıklayın.



Bu işlem, kod düzenleyici içeren Geliştirme görünümünü açar. Kodu doğrudan orada düzenleyebilirsiniz.

Örneğin, Hello, World! olan yanıtı Hello, Node! gibi başka bir ifadeyle değiştirin ve Kaydet'i tıklayın. Proxy kaydedilir ve yeniden dağıtılır.

Son olarak, değişikliği doğrulamak için proxy'yi yeniden çağırın:

$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!

Apigee Edge'de Node.js uygulamalarını çalıştırma hakkında daha fazla bilgi

Tüm Node.js uygulamalarında olduğu gibi, Apigee Edge'de çalışan Node.js uygulamaları tek bir kontrol iş parçacığında çalışır. Başka bir ileti dizisi başlatmaya veya değişkenleri ileti dizileri arasında senkronize etmeye gerek yoktur (ve aslında böyle bir imkan yoktur). Node.js, engellemeyen programlamayı zorunlu kıldığı için tek bir komut dosyası binlerce eşzamanlı isteği destekleyebilir. Bunun nedeni, komut dosyasının bir işlem yapması gerektiğinde CPU'yu bırakmasının ve bu işlem olduğunda daha sonra kendisine bilgi verilmesidir.

Apigee Edge'de Node.js'yi kullanmak için bir ana Node.js komut dosyası belirtmeniz gerekir. Bu komut dosyası, gelen istekleri işleyecek şekilde yapılandırılmalıdır. Bunu genellikle http veya https modüllerini kullanarak, istemci oluşturarak ve benzeri işlemler yaparak yapabilirsiniz. (Ana komut dosyası bu şekilde yapılandırılmazsa dağıtıldıktan sonra yürütülür ve uygulamadan çıkar.) Apigee Edge'de her Node.js uygulama komut dosyası, proxy dağıtıldığında baştan başlatılır ve proxy dağıtımı kaldırıldığında durdurulur. Bu adımlar esnasında yeni istekleri bekler ve işler. Daha fazla bilgi için Bağımsız bir Node.js uygulaması dağıtma başlıklı makalenin "İçe aktarılan bir Node.js dosyasını çağırma" bölümüne bakın.

Sonraki adımlar

Ayrıca, doğrudan dosya sisteminizden bağımsız Node.js uygulamalarını oluşturup dağıtabilirsiniz. Bir sonraki konu olan Bağımsız bir Node.js uygulaması dağıtma, Node.js uygulamasını komut satırından dağıtmak için apigeetool komutunun nasıl kullanılacağını açıklamaktadır.