Azure için yerel JavaScript geliştirme ortamınızı yapılandırma

Geliştiriciler, bulut uygulamaları oluştururken genellikle kodu Azure gibi bir bulut ortamına dağıtmadan önce yerel iş istasyonlarında test etmek için tercih eder. Yerel geliştirme, tanıdık bir ortamla birlikte daha geniş bir araçtan da faydalanma imkanı sunar.

Bu makalede, Azure ile JavaScript için uygun bir yerel geliştirme ortamı oluşturma ve doğrulamaya ilişkin kurulum yönergeleri yer alır.

Bir kez abonelik oluşturma

Azure kaynakları bir abonelik ve kaynak grubu içinde oluşturulur.

Bir kez yazılım yüklemesi

Yerel iş istasyonda JavaScript ile Azure geliştirme, şunları yüklemenizi öneririz:

Azure barındırma çalışma zamanı

Azure web uygulaması veya Azure İşlevleri gibi bir Azure kaynağını uygulamanıza barındırma ortamı olarak kullanmayı planlıyorsanız, Node.js'nin yerel Node.js geliştirme ortamı çalışma zamanı sürümünün kullanmayı planlana Azure kaynak çalışma zamanıyla eşle eşle olduğunu doğrulamanız gerekir.

Önerilen yerel yüklemeler

Yerel geliştirme görevlerinize yardımcı olmak için aşağıdaki yaygın yerel iş istasyonu yüklemeleri önerilir.

Kimlik doğrulaması için bir kez yapılandırma

Yerel geliştirme ve uzak Azure barındırma ortamında aynı kimlik doğrulama kodunu kullanmak için DefaultAzureCredential kullanın.

Tüm ortamlarda aynı kodu kullanmak için:

• Yerel geliştirme için, kişisel hesabınız olmadan Azure kaynaklarını oluşturmak ve yönetmek için bir hizmet sorumlusu oluşturun.
• Azure barındırma için dahafazla bilgi edinin.

Azure ve Azure SDK istemci kitaplıkları ile çalışma

Azure SDK kitaplıkları her hizmet için ayrı ayrı sağlanır. Her kitaplığı, ihtiyacınız olan Azure hizmetine göre yükleyebilirsiniz.

Azure kullanan her yeni proje:

• Azure kaynakları oluşturun ve ilişkili anahtarları veya yapılandırmayı güvenli bir konuma kaydedin.
• NPM veya Yarn'dan Azure SDK kitaplıklarını yükleyin.
• Azure SDK'da kimlik doğrulaması yapmak için yerel Hizmet Sorumlusu kimlik bilgilerinizi kullanın ve ardından belirli hizmetlere erişmek için yapılandırma bilgilerini kullanın.

Yapılandırma bilgilerini güvenli hale getirme

Yapılandırma bilgilerini depolamak için çeşitli seçenekleriniz vardır:

• Azure Key Vault kaynaklarınıza, uygulamalarınıza ve çözümlerinize erişen ve bu anahtarları şifrelerken anahtar oluşturmanızı ve korumanızı sağlar.
• Dotenv, bir dosyadan ortam değişkenlerini okumak için popüler bir npm paketidir. Dosyanın kaynak .env denetimine iade .gitignore edilemez olması için dosyayı dosyaya .env ekleyin. Azure için web uygulamalarına ortam değişkenleri hakkında daha fazla bilgi edinin.

Azure kitaplıkları için ortam değişkenleri oluşturma

Azure SDK kitaplıkları tarafından Azure bulutuna erişmek için gereken Azure ayarlarını kullanmak için ortam değişkenlerine en yaygın değerleri ayarlayın. Aşağıdaki komutlar yerel iş istasyonu için ortam değişkenlerini ayarlar.

Aşağıdaki örneklerde istemci kimliği, hizmet sorumlusu kimliği ve hizmet sorumlusu gizli adıdır.

AZURE_SUBSCRIPTION_ID="aa11bb33-cc77-dd88-ee99-0918273645aa"
AZURE_TENANT_ID="00112233-7777-8888-9999-aabbccddeeff"
AZURE_CLIENT_ID="12345678-1111-2222-3333-1234567890ab"
AZURE_CLIENT_SECRET="abcdef00-4444-5555-6666-1234567890ab"

set AZURE_SUBSCRIPTION_ID="aa11bb33-cc77-dd88-ee99-0918273645aa"
set AZURE_TENANT_ID=00112233-7777-8888-9999-aabbccddeeff
set AZURE_CLIENT_ID=12345678-1111-2222-3333-1234567890ab
set AZURE_CLIENT_SECRET=abcdef00-4444-5555-6666-1234567890ab

Bu komutlarda gösterilen değerleri kendi hizmet sorumlusunuzla değiştirin.

Dosya .env oluşturma

Bir diğer yaygın mekanizma da DOTENV NPM paketini kullanarak bu ayarlar için .env bir dosya oluşturmaktır. kullanmayı planlıyorsanız, .env dosyayı kaynak .env olmadığınızdan emin olun. Dosyayı .env Git'in dosyasına .ignore ekleme, bu ayarların kaynak denetimine iadelendiğinden emin olmak için standart bir yol sağlar.

npm paketlerini yükleme

Her proje için aşağıdaki adımları kullanarak her zaman ayrı bir klasör ve kendi dosyasını package.json oluşturmanızı öneririz:

1. Bir terminal, komut istemi veya bash kabuğu açın ve proje için yeni bir klasör oluşturun. Ardından bu yeni klasöre gidin.

   mkdir MY-NEW-PROJECT && cd MY-NEW-PROJECT
   

2. Paket dosyasını başlatma:

   npm init -y
   

   Bu, package.json dosyasını oluşturur ve minimum özellikleri başlatılır.

3. Aşağıdaki örnekte olduğu gibi ihtiyacınız olan Azure SDK kitaplıklarını yükleyin:

   npm install @azure/ai-text-analytics@5.0.0
   

Kaynak denetimi ile Visual Studio Code

Bir projeyi her başlatan kaynak denetimi deposu oluşturma alışkanlık haline getirmenizi öneririz. Bunu daha sonra Visual Studio Code.

1. Bu Visual Studio Code kaynak denetimi simgesini seçerek Kaynak Denetimi gezginini açın ve ardından Depoyu Başlat'ı seçerek yerel bir Git deposu başlatın:

   

2. Depo başlatıldıktan ve kaynak denetiminde depo uygulanacak dosyalarınız olduktan sonra, iletiyi girin ve onay işaretini seçerek kaynak dosyalarınızın ilk Initial commit işlemeyi oluşturun.

   

3. GitHub veya Azure DevOps yeni bir depo oluşturun ve sonraki birkaç adım için depo URL'sini kopyalayın.

4. Tümleşik Visual Studio terminalde, uzak depoyu yerel depoya eklemek için aşağıdaki git komutunu kullanın. ve YOUR-ALIAS değerlerini YOUR-REPOSITORY kendi değerleriniz ile değiştirin.

   git remote add origin https://github.com/YOUR-ALIAS/YOUR-REPOSITORY
   

Visual Studio Code birçok yerleşik git özelliği içerir. Daha fazla bilgi için, bkz. Using Version Control in VS Code.

Sonraki adımlar

• Hizmet sorumlusu oluşturma ve kullanma
• Node.jsiçin Azure modülleriyle kimlik Node.js