Node.js modülleri için Edge desteğini anlama

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

Apigee Edge'de hangi Node.js sürümü desteklenir?

Edge şu anda Node.js 0.10.32'yi desteklemektedir.

Edge'de hangi standart Node.js modülleri desteklenir?

Desteklenen diğer modüller

Bu bölümde, standart Node.js'de desteklenmeyen ancak Trireme ve Apigee Edge'de çalışan Trireme tarafından desteklenen ek modüller listelenmektedir. Trireme, Apigee Edge'de çalışan açık kaynaklı Node.js kapsayıcısıdır. Java sanal makinesinde (JVM) Node.js komut dosyalarını çalıştırmak için tasarlanmıştır. Bu modüllerin tümü NPM'de kullanılabilir.

Sık kullanılan Node.js modülleri için destek

Node.js komut dosyalarıyla ilgili kısıtlamalar

Ancak Edge'in Node.js komut dosyalarıyla ilgili aşağıdaki gibi belirli kısıtlamalar uyguladığını unutmayın:

• Apigee Edge ortamındaki Node.js uygulamaları, Edge ağ mimarisi nedeniyle UDP üzerinden internetteki hizmetlere erişemez.

• Dosya sistemi erişimi, Node.js komut dosyasının başlatıldığı dizinle (yani /resources/node diziniyle) sınırlıdır. Node.js komut dosyaları, bu dizindeki dosyaları okuyup yazabilir (örneğin, geçici bir çalışma alanı olarak). Ancak dosyaların ne kadar süreyle kalacağı garanti edilmez.

• Gelen TCP bağlantılarını dinleme girişimleri istisna oluşturur.

• Kullanıcı kimliği, grup üyeliği ve çalışma diziniyle ilgili işlevler desteklenmez.

• Standart giriş için, TargetEndpoint'in ScriptTarget öğesini kullanarak bağımsız değişkenler iletmekle sınırlısınız. Daha fazla bilgi için Gelişmiş ScriptTarget yapılandırması bölümüne bakın.
  
• Standart çıkış için, Edge yönetim kullanıcı arayüzünde proxy'niz için Node.js günlükleri düğmesini kullanmakla sınırlısınız. "apigeetool getlogs" komutunu da kullanabilirsiniz. Daha fazla bilgi için Bağımsız bir Node.js uygulamasını dağıtma başlıklı makaleyi inceleyin.
  
• Yerel koda bağlı modüller desteklenmez.
  
• Promises ve Generators gibi EcmaScript 6 özelliklerine bağlı modüller desteklenmez.
  
• "harmony-proxies" gibi Node.js çalışma zamanı işaretleri desteklenmez.

Private Cloud için Edge'de IP bağlantısı kısıtlamaları ayarlama

Edge for Private Cloud, Node.js kodunun "10." ile başlayan IP adreslerine erişmesini kısıtlayabilir. "192.168" ve localhost. Bu IP adreslerine erişmeye çalışırsanız aşağıdaki biçimde bir hata görürsünüz:

{ [Error: connect EINVAL] message: 'connect EINVAL', code: 'EINVAL', errno: 'EINVAL', syscall: 'connect' }

Bu kısıtlamaları, her bir Mesaj İşleyici için message-processors.properties dosyasında conf_nodejs_connect.ranges.denied özelliğini ayarlayarak değiştirebilirsiniz. Bu özelliğin varsayılan değeri şudur:

• Edge 4.17.05 ve önceki sürümler: conf_nodejs_connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32
• Edge 4.17.09 ve sonraki sürümler: conf_nodejs_connect.ranges.denied= (yani kısıtlama yok)

Bu özelliği ayarlamak için:

1. message-processor.properties dosyasını bir düzenleyicide açın. Dosya yoksa oluşturun:
   > vi /<inst_root>/apigee/customer/application/message-processor.properties
2. Özelliği istediğiniz gibi ayarlayın. Örneğin, yalnızca localhost'a erişimi reddetmek için:
   conf_nodejs_connect.ranges.denied=127.0.0.1/32
3. Değişikliklerinizi kaydedin.
4. Özellikler dosyasının "apigee" kullanıcısına ait olduğundan emin olun:
   > chown apigee:apigee /<inst_root>/apigee/customer/application/message-processor.properties
5. Mesaj İşleyici'yi yeniden başlatın:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-message-processor restart

http ve https modülleri için desteği anlama

Apigee Edge'de çalışan tüm Node.js uygulamaları, gelen istekleri dinlemek için http veya https modülünü kullanmalıdır. Gelen istekleri dinlemeyen bir komut dosyası dağıtırsanız bu komut dosyası yalnızca yürütülür ve çıkar.

Node.js'deki http ve https modüllerinin listen yöntemi, bağlantı noktası numarasını parametre olarak alır. Örneğin:

svr.listen(process.env.PORT || 9000, function() {
   console.log('The server is running.');
});

Bu "bağlantı noktası" bağımsız değişkeni Node.js'de zorunludur ancak Apigee Edge bu parametreyi yoksayar. Bunun yerine, Node.js komut dosyasının çalıştığı API proxy'si, dinlediği "sanal ana makineyi" belirtir ve Node.js uygulaması, diğer tüm Apigee Edge proxy'leri gibi aynı sanal ana makineleri kullanır.

Apigee'deki her ortamda en az bir sanal ana makine bulunur. Sanal ana makine, Apigee kuruluşuyla bağlantı için HTTP ayarlarını tanımlar. Bir ortamdaki tüm API proxy'leri aynı sanal ana makineleri paylaşır. Varsayılan olarak her ortam için iki sanal ana makine kullanılabilir: default ve secure. Daha fazla bilgi için Sanal Ana Makine Alma ve API geliştirme yaşam döngüsü başlıklı makaleleri inceleyin.

apigeetool deploynodeapp komutu, Node.js uygulaması etrafında bir Apigee Edge proxy sarmalayıcısı oluşturur. Dağıtıldığında Node.js uygulaması, ortam için tanımlanan varsayılan sanal ana makineyi dinler. Node.js uygulamasının URL'si her zaman http://{org_name}-{env_name}.apigee.net olur.

Gelen istekleri işleme

Diğer Apigee Edge uygulamalarında olduğu gibi, proxy uygulaması secure sanal ana makinesinde dinleyecek şekilde ayarlanırsa HTTPS kullanan gelen istekleri kabul eder.

Giden istekleri işleme

Apigee Edge'deki Node.js uygulamaları, gelen trafiği almanın yanı sıra diğer Node.js uygulamaları gibi giden istekler göndermek için http ve https modüllerini kullanabilir. Bu modüller, Node.js'de her zaman olduğu gibi çalışır.

TLS modülü desteğini anlama

Apigee Edge, Node.js tls modülünü destekler. Bu modül, Taşıma Katmanı Güvenliği (TLS) ve/veya Güvenli Yuva Katmanı (SSL) şifreli akış iletişimi sağlamak için OpenSSL'yi kullanır. Edge'de çalışan Node.js uygulamalarından arka uç hizmetlerine güvenli bağlantılar oluşturmak için tls modülünü kullanabilirsiniz.

tls modülünün Apigee Edge'de nasıl çalıştığını anlamak için virtual hosts'lerin Apigee Edge'de nasıl kullanıldığını anlamak önemlidir. Apigee'deki her ortamda en az bir sanal ana makine bulunur. Sanal ana makine, Apigee kuruluşuyla bağlantı için HTTP ayarlarını tanımlar. Bir ortamdaki tüm API proxy'leri aynı sanal ana makineleri paylaşır. Varsayılan olarak, her ortam için iki sanal ana makine kullanılabilir: default ve secure. Sanal ana makineler hakkında daha fazla bilgi için Sanal Ana Makine Alma ve API geliştirme yaşam döngüsü başlıklı makalelere bakın.

Şimdi de Apigee Edge'in Node.js uygulamalarındaki gelen ve giden istekler için TLS (SSL) iletişimini nasıl işlediğine bakalım:

Gelen istekleri işleme

Kuruluşunuz için sanal ana makinelerin nasıl yapılandırıldığına bağlı olarak Edge aşağıdaki seçenekleri sunar:

• API proxy'si default sanal ana makinesinde dinleyecek şekilde yapılandırılmışsa HTTP üzerinden istekleri kabul eder.
• API proxy'si secure sanal ana makinesinde dinleyecek şekilde yapılandırılmışsa HTTPS üzerinden istekleri kabul eder. URL, apigee.net alanında olacak ve *.apigee.net için joker karakterli bir SSL sertifikası kullanılacaktır. Uygulamalar apigee.net alanına istek gönderdiği sürece SSL sertifikası normal şekilde doğrulanır.

Giden istekleri işleme

tls modülüyle giden istekleri, Node.js'de normalde yaptığınız gibi gönderebilirsiniz. Temel olarak, istemci tarafı anahtarlarını ve sertifikalarını (.pem dosyaları) resources/node dizinine eklemeniz ve bunları komut dosyanızda yüklemeniz gerekir. tls modülünü ve yöntemlerini kullanma hakkında bilgi edinmek için Node.js tls modülü belgelerine bakın.

Gelişmiş ScriptTarget Yapılandırması

<TargetEndpoint name="default">
  <ScriptTarget>
     <ResourceURL>node://hello.js</ResourceURL>
     <EnvironmentVariables>
         <EnvironmentVariable name="NAME">VALUE</EnvironmentVariable> 
     </EnvironmentVariables>
     <Arguments>
         <Argument>ARG</Argument>
     </Arguments>
  </ScriptTarget>
</TargetEndpoint>