Visual Studio ile Azure Cloud Services (genişletilmiş destek) rollerini yapılandırma

Not

Bu makale Azure Azure Cloud Services (genişletilmiş destek) için geçerlidir. Cloud Services (klasik) 31 Ağustos 2024 itibarıyla kullanımdan kaldırılmıştır. Daha fazla bilgi için bkz . Bulut hizmetleri (klasik) dağıtım modeli 31 Ağustos 2024'te kaldırılıyor. Yeni geliştirme için, Azure Uygulaması Hizmeti, Azure İşlevleri veya Azure Container Apps gibi belirli bir amaç için tasarlanmış daha yeni bir hizmet türü kullanmanızı öneririz. Kullanılabilir hizmetlerin en son listesi için bkz . Azure ürünleri dizini.

Azure Cloud Services (genişletilmiş destek) projesinde bir veya daha fazla çalışan veya web rolü olabilir. Her rol için bu rolün nasıl ayarlandığını tanımlamanız ve ayrıca rolün nasıl çalıştırılacağını yapılandırmanız gerekir.

Bulut hizmetinizin bilgileri aşağıdaki dosyalarda depolanır:

  • ServiceDefinition.csdef - Hizmet tanımı dosyası, hangi rollerin gerekli olduğu, uç noktalar ve sanal makine boyutu dahil olmak üzere bulut hizmetinizin çalışma zamanı ayarlarını tanımlar. Rolünüz çalışırken içinde ServiceDefinition.csdef depolanan verilerin hiçbiri değiştirilemez.
  • ServiceConfiguration.cscfg - Hizmet yapılandırma dosyası, bir rolün kaç örneğinin çalıştırıldığından ve bir rol için tanımlanan ayarların değerlerinden yapılandırılır. içinde depolanan ServiceConfiguration.cscfg veriler, rolünüz çalışırken değiştirilebilir.

Bir rolün nasıl çalıştırılacağını denetleen ayarlar için farklı değerler depolamak için birden çok hizmet yapılandırması tanımlayabilirsiniz. Her dağıtım ortamı için farklı bir hizmet yapılandırması kullanabilirsiniz. Örneğin, depolama hesabınızı bağlantı dizesi yerel bir hizmet yapılandırmasında yerel Azure Depolama Öykünücüsü kullanacak şekilde ayarlayabilir ve bulutta Azure Depolama'yı kullanmak için başka bir hizmet yapılandırması oluşturabilirsiniz.

Visual Studio'da bir Azure Cloud Services (genişletilmiş destek) projesi oluşturduğunuzda otomatik olarak iki hizmet yapılandırması oluşturulur ve Azure projenize eklenir:

  • ServiceConfiguration.Cloud.cscfg
  • ServiceConfiguration.Local.cscfg

Önkoşullar

Azure Cloud Services (genişletilmiş destek) projesi yapılandırma

Aşağıdaki adımlarda gösterildiği gibi Visual Studio'daki Çözüm Gezgini bir Azure Cloud Services (genişletilmiş destek) projesi yapılandırabilirsiniz:

  1. Visual Studio'da Azure Cloud Services (genişletilmiş destek) projesi oluşturun veya açın.

  2. Çözüm Gezgini projeye sağ tıklayın ve bağlam menüsünden Özellikler'i seçin.

    proje bağlam menüsünü Çözüm Gezgini

  3. Projenin özellikler sayfasında Geliştirme sekmesini seçin.

    Proje özellikleri sayfası - geliştirme sekmesi

  4. Hizmet Yapılandırması listesinde, düzenlemek istediğiniz hizmet yapılandırmasının adını seçin.

    Azure Cloud Services (genişletilmiş destek) projesinin Hizmet Yapılandırması listesini gösteren ekran görüntüsü.

Rol örneklerinin sayısını değiştirme

Bulut hizmetinizin performansını geliştirmek için, çalışan bir rolün örnek sayısını, kullanıcı sayısına veya belirli bir rol için beklenen yüke göre değiştirebilirsiniz. Bulut hizmeti Azure'da çalıştırıldığında bir rolün her örneği için ayrı bir sanal makine oluşturulur. Bu, bu bulut hizmetinin dağıtımı için faturalandırmayı etkiler. Faturalama hakkında daha fazla bilgi için bkz . Microsoft Azure faturanızı anlama.

  1. Visual Studio'da Azure Cloud Services (genişletilmiş destek) projesi oluşturun veya açın.

  2. Çözüm Gezgini'da proje düğümünü genişletin. Roller düğümü altında, güncelleştirmek istediğiniz role sağ tıklayın ve bağlam menüsünden Özellikler'i seçin.

    Azure rol bağlam menüsünü Çözüm Gezgini

  3. Yapılandırma sekmesini seçin.

    Yapılandırma sekmesi

  4. Hizmet Yapılandırması listesinde, güncelleştirmek istediğiniz hizmet yapılandırmasını seçin. (Bu rol için tüm hizmet yapılandırmalarında değişiklik yapmak istiyorsanızTüm Yapılandırmalar.)

    Önemli

    Belirli bir hizmet yapılandırmasını seçerseniz, bazı özellikler yalnızca tüm yapılandırmalar için ayarlanabildiği için devre dışı bırakılır. Bu özellikleri düzenlemek için Tüm Yapılandırmalar'ı seçmeniz gerekir.

    Hizmet Yapılandırması listesi 1

  5. Örnek sayısı metin kutusuna, bu rol için başlatmak istediğiniz örnek sayısını girin. Bulut hizmetini Azure'da yayımladığınızda her örnek ayrı bir sanal makinede çalışır.

    Örnek Sayısını Güncelleştirme

  6. Visual Studio araç çubuğunda Kaydet'i seçin.

Depolama hesapları için bağlantı dizesi yönetme

Hizmet yapılandırmalarınız için bağlantı dizesi ekleyebilir, kaldırabilir veya değiştirebilirsiniz. Azure'da depolama hesabı kullanan bir bulut hizmeti yapılandırması da yapılandırmak isteyebilirsiniz.

Uyarı

Bir depolama hesabı bağlantı dizesi için Azure Depolama hesabı anahtarı bilgilerini girdiğinizde, bu bilgiler hizmet yapılandırma dosyasında yerel olarak depolanır. Ancak, bu bilgiler şu anda şifrelenmiş metin olarak depolanmamaktadır.

Her hizmet yapılandırması için farklı bir değer kullanarak bulut hizmetinizde farklı bağlantı dizesi kullanmanız veya bulut hizmetinizi Azure'da yayımlarken kodunuzu değiştirmeniz gerekmez. Kodunuzdaki bağlantı dizesi için aynı adı kullanabilirsiniz ve değer, bulut hizmetinizi oluştururken veya yayımlarken seçtiğiniz hizmet yapılandırmasına göre farklıdır.

  1. Visual Studio'da Azure Cloud Services (genişletilmiş destek) projesi oluşturun veya açın.

  2. Çözüm Gezgini'da proje düğümünü genişletin. Roller düğümü altında, güncelleştirmek istediğiniz role sağ tıklayın ve bağlam menüsünden Özellikler'i seçin.

    Azure rol bağlam menüsünü Çözüm Gezgini

  3. Ayarlar sekmesini seçin.

    Ayarlar sekmesi

  4. Hizmet Yapılandırması listesinde, güncelleştirmek istediğiniz hizmet yapılandırmasını seçin.

    Hizmet Yapılandırması

  5. bağlantı dizesi eklemek için Ayar Ekle'yi seçin.

    bağlantı dizesi ekle

  6. Yeni ayar listeye eklendikten sonra, listedeki satırı gerekli bilgilerle güncelleştirin.

    Yeni bağlantı dizesi

    • Ad - bağlantı dizesi için kullanmak istediğiniz adı girin.
    • Tür - Açılan listeden Bağlantı Dizesi'ni seçin.
    • Değer - bağlantı dizesi doğrudan Değer hücresine girebilir veya Depolama Bağlantı Dizesi Oluştur iletişim kutusunda çalışmak üzere üç noktayı (...) seçebilirsiniz.
  7. Depolama Bağlantı Dizesi Oluştur iletişim kutusunda Kullanarak bağlan seçeneğini belirleyin. Ardından, seçtiğiniz seçeneğin yönergelerini izleyin:

    • Microsoft Azure Depolama Öykünücüsü - Bu seçeneği seçerseniz, iletişim kutusundaki diğer ayarlar yalnızca Azure'a uygulandığından devre dışı bırakılır. Tamam'ı seçin.
    • Aboneliğiniz - Bu seçeneği seçerseniz, açılan listeyi kullanarak bir Microsoft hesabı seçin ve oturum açın veya bir Microsoft hesabı ekleyin. Bir Azure aboneliği ve depolama hesabı seçin. Tamam'ı seçin.
    • El ile girilen kimlik bilgileri - Depolama hesabı adını ve birincil veya ikinci anahtarı girin. Bağlantı için bir seçenek belirleyin (çoğu senaryo için HTTPS önerilir.) Tamam'ı seçin.
  8. bir bağlantı dizesi silmek için bağlantı dizesi seçin ve ardından Ayarı Kaldır'ı seçin.

  9. Visual Studio araç çubuğunda Kaydet'i seçin.

Program aracılığıyla bir bağlantı dizesi erişme

Aşağıdaki adımlar, C# kullanarak bir bağlantı dizesi program aracılığıyla nasıl erişeceğini gösterir.

  1. Ayarı kullanacağınız C# dosyasına aşağıdaki using yönergelerini ekleyin:

    using Microsoft.WindowsAzure;
    using Microsoft.WindowsAzure.Storage;
    using Microsoft.WindowsAzure.ServiceRuntime;
    
  2. Aşağıdaki kodda, bir bağlantı dizesi erişme örneği gösterilmektedir. ConnectionStringName> yer tutucusunun <yerine uygun değeri yazın.

    // Setup the connection to Azure Storage
    var storageAccount = CloudStorageAccount.Parse(RoleEnvironment.GetConfigurationSettingValue("<ConnectionStringName>"));
    

Azure Cloud Services (genişletilmiş destek) projenizde kullanmak üzere özel ayarlar ekleme

Hizmet yapılandırma dosyasındaki özel ayarlar, belirli bir hizmet yapılandırması için bir dize için ad ve değer eklemenize olanak tanır. Ayarın değerini okuyarak ve kodunuzdaki mantığı denetlemek için bu değeri kullanarak bulut hizmetinizdeki bir özelliği yapılandırmak için bu ayarı kullanmayı seçebilirsiniz. Hizmet paketinizi yeniden oluşturmanıza gerek kalmadan veya bulut hizmetiniz çalışırken bu hizmet yapılandırma değerlerini değiştirebilirsiniz. Kodunuz, bir ayarın ne zaman değiştiğine ilişkin bildirimleri denetleyebilir. Daha fazla bilgi için bkz . RoleEnvironment.Changing Event.

Hizmet yapılandırmalarınız için özel ayarlar ekleyebilir, kaldırabilir veya değiştirebilirsiniz. Farklı hizmet yapılandırmaları için bu dizeler için farklı değerler isteyebilirsiniz.

Her hizmet yapılandırması için farklı bir değer kullandığınızda, bulut hizmetinizde farklı dizeler kullanmanız veya bulut hizmetinizi Azure'da yayımlarken kodunuzu değiştirmeniz gerekmez. Kodunuzdaki dize için aynı adı kullanabilirsiniz ve değer, bulut hizmetinizi oluştururken veya yayımlarken seçtiğiniz hizmet yapılandırmasına göre farklıdır.

  1. Visual Studio'da Azure Cloud Services (genişletilmiş destek) projesi oluşturun veya açın.

  2. Çözüm Gezgini'da proje düğümünü genişletin. Roller düğümü altında, güncelleştirmek istediğiniz role sağ tıklayın ve bağlam menüsünden Özellikler'i seçin.

    Azure rol bağlam menüsünü Çözüm Gezgini

  3. Ayarlar sekmesini seçin.

    Ayarlar sekmesi

  4. Hizmet Yapılandırması listesinde, güncelleştirmek istediğiniz hizmet yapılandırmasını seçin.

    Hizmet Yapılandırması listesi 2

  5. Özel ayar eklemek için Ayar Ekle'yi seçin.

    Özel ayar ekle

  6. Yeni ayar listeye eklendikten sonra, listedeki satırı gerekli bilgilerle güncelleştirin.

    Yeni özel ayar

    • Ad - Ayarın adını girin.
    • Tür - Açılan listeden Dize'yi seçin.
    • Değer - Ayarın değerini girin. Değeri doğrudan Değer hücresine girebilir veya Dizeyi Düzenle iletişim kutusunda değeri girmek için üç noktayı (...) seçebilirsiniz.
  7. Özel bir ayarı silmek için ayarı seçin ve ardından Ayarı Kaldır'ı seçin.

  8. Visual Studio araç çubuğunda Kaydet'i seçin.

Program aracılığıyla özel bir ayarın değerine erişme

Aşağıdaki adımlarda, C# kullanarak özel bir ayara program aracılığıyla erişme adımları gösterilmektedir.

  1. Ayarı kullanacağınız C# dosyasına aşağıdaki using yönergelerini ekleyin:

    using Microsoft.WindowsAzure;
    using Microsoft.WindowsAzure.Storage;
    using Microsoft.WindowsAzure.ServiceRuntime;
    
  2. Aşağıdaki kodda özel bir ayara erişme örneği gösterilmektedir. SettingName> yer tutucusunun <yerine uygun değeri yazın.

    var settingValue = RoleEnvironment.GetConfigurationSettingValue("<SettingName>");
    

Her rol örneği için yerel depolamayı yönetme

Bir rolün her örneği için yerel dosya sistemi depolama alanı ekleyebilirsiniz. Bu depolamada depolanan verilere, verilerin depolandığı rolün diğer örnekleri veya başka roller tarafından erişilemez.

  1. Visual Studio'da Azure Cloud Services (genişletilmiş destek) projesi oluşturun veya açın.

  2. Çözüm Gezgini'da proje düğümünü genişletin. Roller düğümü altında, güncelleştirmek istediğiniz role sağ tıklayın ve bağlam menüsünden Özellikler'i seçin.

    Azure rol bağlam menüsünü Çözüm Gezgini

  3. Yerel Depolama sekmesini seçin.

    Yerel depolama sekmesi

  4. Hizmet Yapılandırması listesinde, yerel depolama ayarları tüm hizmet yapılandırmalarına uygulandığından Tüm Yapılandırmalar'ın seçildiğinden emin olun. Diğer tüm değerler sayfadaki tüm giriş alanlarının devre dışı bırakılmasına neden olur.

    Hizmet Yapılandırması listesi 3

  5. Yerel depolama girdisi eklemek için Yerel Depolama Ekle'yi seçin.

    Yerel depolama alanı ekleme

  6. Yeni yerel depolama girdisi listeye eklendikten sonra, listedeki satırı gerekli bilgilerle güncelleştirin.

    Yeni yerel depolama girdisi

    • Ad - Yeni yerel depolama için kullanmak istediğiniz adı girin.
    • Boyut (MB) - Yeni yerel depolama için ihtiyacınız olan boyutu MB cinsinden girin.
    • Rol geri dönüşümünde temizle - Rolün sanal makinesi geri dönüştürüldiğinde yeni yerel depolamadaki verileri kaldırmak için bu seçeneği belirleyin.
  7. Yerel depolama girdisini silmek için girdiyi seçin ve ardından Yerel Depolamayı Kaldır'ı seçin.

  8. Visual Studio araç çubuğunda Kaydet'i seçin.

Program aracılığıyla yerel depolamaya erişme

Bu bölümde, bir test metin dosyası MyLocalStorageTest.txtyazarak C# kullanarak yerel depolamaya program aracılığıyla erişme işlemi gösterilmektedir.

Yerel depolama alanına metin dosyası yazma

Aşağıdaki kod, yerel depolama alanına metin dosyası yazma işleminin bir örneğini gösterir. <LocalStorageName> yer tutucusunun yerine uygun değeri yazın.

// Retrieve an object that points to the local storage resource
LocalResource localResource = RoleEnvironment.GetLocalResource("<LocalStorageName>");

//Define the file name and path
string[] paths = { localResource.RootPath, "MyLocalStorageTest.txt" };
String filePath = Path.Combine(paths);

using (FileStream writeStream = File.Create(filePath))
{
    Byte[] textToWrite = new UTF8Encoding(true).GetBytes("Testing Web role storage");
    writeStream.Write(textToWrite, 0, textToWrite.Length);
}

Yerel depolama alanına yazılmış bir dosyayı bulma

Önceki bölümde kod tarafından oluşturulan dosyayı görüntülemek için şu adımları izleyin:

  1. Windows bildirim alanında Azure simgesine sağ tıklayın ve bağlam menüsünde İşlem Öykünücüsü Kullanıcı Arabirimini Göster'i seçin.

    Azure işlem öykünücüslerini gösterme

  2. Web rolünü seçin.

    Azure işlem öykünücüsü

  3. Microsoft Azure İşlem Öykünücüsü menüsünde Araçlar>Yerel mağazayı aç'ı seçin.

    Yerel mağaza menü öğesini aç

  4. Windows Gezgini penceresi açıldığında, Ara metin kutusuna 'MyLocalStorageTest.txt' yazın ve aramayı başlatmak için Enter'ı seçin.

Azure Projesini Yapılandırma makalesini okuyarak Visual Studio'daki Azure projeleri hakkında daha fazla bilgi edinin. Şema Başvurusu'na bakarak bulut hizmeti şeması hakkında daha fazla bilgi edinin.