Hızlı Başlangıç: Redis için Azure Cache'da Node.js

Makale
11/25/2021
Okumak için 5 dakika

Bu hızlı başlangıçta, Azure Redis için Azure Cache herhangi bir Node.js erişilebilen güvenli ve ayrılmış bir önbelleğe erişim sağlamak için bir Node.js uygulamasına veri eksersiniz.

Doğrudan koda atlamak için bkz.Node.js hızlı GitHub.

Önkoşullar

Azure aboneliği - ücretsiz bir abonelik oluşturun
node_rediskomutuyla yüklebilirsiniz. npm install redis

Diğer Node.js istemcilerini kullanmaya ilişkin örnekler için Node.js Redis istemcileri listesindeki Node.js istemcilerinin kendi belgelerine bakın.

Bir önbellek oluşturma

Önbellek oluşturmak için Azure Portal oturum açın ve kaynak oluştur' u seçin.
Yeni sayfada veritabanları ' nı seçin ve ardından redsıs için Azure önbelleği' ni seçin.

Yeni Redis Cache sayfasında, yeni önbelleğiniz için ayarları yapılandırın.

Ayar	Değer seçme	Açıklama
Abonelik	Açılır ve aboneliğinizi seçin.	Redsıs örneği için bu yeni Azure önbelleğinin oluşturulacağı abonelik.
Kaynak grubu	Açılır ve bir kaynak grubu seçin veya Yeni oluştur ' u seçin ve yeni bir kaynak grubu adı girin.	Önbelleğinizin ve diğer kaynaklarınızın oluşturulacağı kaynak grubunun adı. Tüm uygulama kaynaklarınızı tek bir kaynak grubuna yerleştirerek, bunları birlikte kolayca yönetebilir veya silebilirsiniz.
DNS adı	Benzersiz bir ad girin.	Önbellek adı yalnızca rakam, harf veya kısa çizgi içeren 1 ile 63 karakter arasında bir dize olmalıdır. Ad bir sayı veya harfle başlamalı ve bitmeli ve ardışık kısa çizgi içeremez. Önbellek örneğinizin ana bilgisayar adı <DNS name> . Redis.cache.Windows.net olacaktır.
Konum	Açılır ve bir konum seçin.	Önbelleğinizi kullanacak diğer hizmetlerin yakınında bir bölge seçin.
Önbellek türü	Açılır ve bir Katmanseçin.	Katman, önbellek için kullanılabilen boyut, performans ve özellikleri belirler. Daha fazla bilgi için bkz. redsıs Için Azure önbelleği 'Ne genel bakış.

Ağ sekmesini seçin veya sayfanın altındaki ağ düğmesini seçin.
Ağ sekmesinde, bağlantı yönteminizi seçin.
İleri: Gelişmiş sekmesini seçin veya sayfanın altındaki İleri: Gelişmiş düğmesini seçin.
Bir temel veya standart önbellek örneğinin Gelişmiş SEKMESINDE, TLS olmayan bir bağlantı noktasını etkinleştirmek istiyorsanız geçişi etkinleştir ' i seçin. Ayrıca, 4 veya 6 ' da kullanmak istediğiniz redo sürümünü seçebilirsiniz.
Premium önbellek örneğinin Gelişmiş SEKMESINDE, TLS olmayan bağlantı noktası, kümeleme ve veri kalıcılığı için ayarları yapılandırın. Ayrıca, 4 veya 6 ' da kullanmak istediğiniz redo sürümünü seçebilirsiniz.
Sonraki: Etiketler sekmesini seçin veya sayfanın altındaki Sonraki: Etiketler düğmesini seçin.
İsteğe bağlı olarak, Etiketler sekmesinde, kaynağı sınıflandırmak istiyorsanız ad ve değeri girin.
Gözden geçir ve oluştur’u seçin. Azure 'un yapılandırmanızı doğruladığı, gözden geçir + Oluştur sekmesine götürülürsünüz.
Yeşil doğrulama başarılı iletisi göründüğünde Oluştur' u seçin.

Önbelleğin oluşturulması biraz zaman alır. Redsıs genel bakış sayfasında ilerlemeyi izleyebilirsiniz. Durum çalışıyor olarak görüntülendiğinde, önbellek kullanıma hazırdır.

Azure portal ana bilgisayar adı, bağlantı noktaları ve erişim anahtarlarını alın

Redsıs örneği için bir Azure önbelleğine bağlanmak üzere önbellek istemcilerinin, önbellek için ana bilgisayar adı, bağlantı noktaları ve bir anahtar olması gerekir. Bazı istemciler bu öğelere biraz daha farklı adlarla başvurabilir. Ana bilgisayar adı, bağlantı noktaları ve anahtarları Azure Portaledinebilirsiniz.

Önbellek sol gezininizden erişim anahtarlarını almak için erişim tuşları' nı seçin.
Ana bilgisayar adını ve bağlantı noktalarını, önbellek sol gezininizden almak için Özellikler' i seçin. Ana bilgisayar adı <DNS name> . Redis.cache.Windows.net biçimindedir.

ANA BİLGİSAYAR ADI ve Birincil erişim anahtarınız için ortam değişkenleri ekleyin. Hassas bilgileri doğrudan kodunuz içine dahil etmek yerine bu değişkenleri kodunuzdan kullanın.

set REDISCACHEHOSTNAME=contosoCache.redis.cache.windows.net
set REDISCACHEKEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

set REDISCACHEHOSTNAME=contosoCache.redis.cache.windows.net
set REDISCACHEKEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Önbelleğe bağlanma

En son derlemeleri node_redis TLS kullanarak Redis için Azure Cache için destek sağlar. Aşağıdaki örnekte 6380 TLS uç noktasını kullanarak Redis için Azure Cache veritabanına nasıl bağlanılacak açıklandı.

var redis = require("redis");

// Add your cache name and access key.
var client = redis.createClient(6380, process.env.REDISCACHEHOSTNAME,
    {auth_pass: process.env.REDISCACHEKEY, tls: {servername: process.env.REDISCACHEHOSTNAME}});

Kodundaki her işlem için yeni bir bağlantı oluşturma. Bunun yerine, mümkün olduğunca bağlantıları yeniden kullanın.

Yeni bir Node.js uygulaması oluşturma

redistest.js adlı yeni bir betik dosyası oluşturun. Gerekli paketleri npm install redis bluebird yüklemek için komutunu kullanın.

Aşağıdaki örnek JavaScript’i dosyaya ekleyin. Bu kod, önbellek ana bilgisayar adını ve Redis için Azure Cache ortam değişkenlerini kullanarak bir Redis için Azure Cache örneğine nasıl bağlanacaklarını gösterir. Kod ayrıca önbellekte bir dize değeri depolar ve alır. Ayrıca PING ve CLIENT LIST komutları da yürütüldü. Redis’i node_redis istemcisiyle kullanmaya ilişkin daha fazla örnek için bkz. https://redis.js.org/.

var redis = require("redis");
var bluebird = require("bluebird");

// Convert Redis client API to use promises, to make it usable with async/await syntax
bluebird.promisifyAll(redis.RedisClient.prototype);
bluebird.promisifyAll(redis.Multi.prototype);

async function testCache() {

    // Connect to the Azure Cache for Redis over the TLS port using the key.
    var cacheConnection = redis.createClient(6380, process.env.REDISCACHEHOSTNAME, 
        {auth_pass: process.env.REDISCACHEKEY, tls: {servername: process.env.REDISCACHEHOSTNAME}});
        
    // Perform cache operations using the cache connection object...

    // Simple PING command
    console.log("\nCache command: PING");
    console.log("Cache response : " + await cacheConnection.pingAsync());

    // Simple get and put of integral data types into the cache
    console.log("\nCache command: GET Message");
    console.log("Cache response : " + await cacheConnection.getAsync("Message"));    

    console.log("\nCache command: SET Message");
    console.log("Cache response : " + await cacheConnection.setAsync("Message",
        "Hello! The cache is working from Node.js!"));    

    // Demonstrate "SET Message" executed as expected...
    console.log("\nCache command: GET Message");
    console.log("Cache response : " + await cacheConnection.getAsync("Message"));    

    // Get the client list, useful to see if connection list is growing...
    console.log("\nCache command: CLIENT LIST");
    console.log("Cache response : " + await cacheConnection.clientAsync("LIST"));    
}

testCache();

Node.js ile betiği çalıştırın.

node redistest.js

Aşağıdaki örnekte, Message anahtarının Azure portalındaki Redis Konsolu kullanılarak ayarlanan, önceden önbelleğe alınmış bir değer içerdiğini görebilirsiniz. Uygulama, önbelleğe alınan bu değeri güncelleştirdi. Ayrıca uygulama, PING ve CLIENT LIST komutlarını da yürüttü.

Redis Cache uygulama tamamlandı

Kaynakları temizleme

Sonraki öğreticiye devam edersanız, bu hızlı başlangıçta oluşturulan kaynakları saklayarak yeniden kullanabilirsiniz.

Aksi takdirde hızlı başlangıç örnek uygulamasını tamamladıysanız ücret ödememek için bu hızlı başlangıçta oluşturulan Azure kaynaklarını silebilirsiniz.

Önemli

Bir kaynak grubunu silme işlemi geri alınamaz ve kaynak grubunun ve içindeki tüm kaynaklar kalıcı olarak silinir. Yanlış kaynak grubunu veya kaynakları yanlışlıkla silmediğinizden emin olun. Bu örneği tutmak istediğiniz kaynakları içeren mevcut bir kaynak grubunda barındırmak için kaynakları oluşturduysanız, kaynak grubunu silmek yerine her kaynağı tek tek silebilirsiniz.

Azure portalda oturum açın ve Kaynak grupları’nı seçin.

Ad alanına göre filtrele metin kutusuna kaynak grubu grubunun adını girin. Bu makaledeki yönergelerde TestResources adlı bir kaynak grubu kullanılmıştır. Sonuç listesinde kaynak grubu üzerinde ... öğesini ve ardından Kaynak grubunu sil'i seçin.

Azure Kaynak grubunu silme

Kaynak grubunun silinmesini onaylamanız istenecektir. Onaylamak için kaynak grubu adının girin ve Sil'i seçin.

Birkaç dakika sonra kaynak grubu ve içerdiği kaynakların tümü silinir.

Sonraki adımlar

Bu hızlı başlangıçta, bir uygulamanın Redis için Azure Cache kullanmayı Node.js öğrendiniz. Yeni bir web uygulamasıyla Redis için Azure Cache sonraki hızlı ASP.NET devam edin.

Bir ASP.NET web uygulaması Redis için Azure Cache.