Mengonfigurasi peran layanan cloud Azure dengan Visual Studio

Berlaku untuk: Visual Studio Visual Studio untuk Mac Visual Studio Code

Layanan cloud Azure dapat memiliki satu atau beberapa peran pekerja atau web. Untuk setiap peran, Anda perlu menentukan bagaimana peran tersebut disiapkan dan juga mengonfigurasi bagaimana peran tersebut berjalan.

Informasi untuk layanan awan Anda disimpan dalam file berikut:

• ServiceDefinition.csdef - File definisi layanan menentukan pengaturan run-time untuk layanan cloud Anda termasuk peran apa yang diperlukan, titik akhir, dan ukuran komputer virtual. Tidak ada data yang disimpan di ServiceDefinition.csdef yang dapat diubah saat peran Anda berjalan.
• ServiceConfiguration.cscfg - File konfigurasi layanan mengonfigurasi berapa banyak instans peran yang dijalankan dan nilai pengaturan yang ditentukan untuk peran. Data yang disimpan ServiceConfiguration.cscfg di dapat diubah saat peran Anda sedang berjalan.

Untuk menyimpan nilai yang berbeda untuk pengaturan yang mengontrol cara peran berjalan, Anda dapat menentukan beberapa konfigurasi layanan. Anda dapat menggunakan konfigurasi layanan yang berbeda untuk setiap lingkungan penyebaran. Misalnya, Anda dapat mengatur string koneksi akun penyimpanan untuk menggunakan Emulator Azure Storage lokal dalam konfigurasi layanan lokal dan membuat konfigurasi layanan lain untuk menggunakan penyimpanan Azure di cloud.

Saat Anda membuat layanan cloud Azure di Visual Studio, dua konfigurasi layanan secara otomatis dibuat dan ditambahkan ke proyek Azure Anda:

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

Mengonfigurasi layanan cloud Azure

Anda dapat mengonfigurasi layanan cloud Azure dari Penjelajah Solusi di Visual Studio, seperti yang diperlihatkan dalam langkah-langkah berikut:

1. Membuat atau membuka proyek layanan cloud Azure di Visual Studio.

2. Di Penjelajah Solusi, klik kanan proyek, dan, dari menu konteks, pilih Properti.

   

3. Di halaman properti proyek, pilih tab Pengembangan.

   

4. Di daftar Konfigurasi Layanan , pilih nama konfigurasi layanan yang ingin Anda edit. (Jika Anda ingin membuat perubahan pada semua konfigurasi layanan untuk peran ini, pilih Semua Konfigurasi.)

   Penting

   Jika Anda memilih konfigurasi layanan tertentu, beberapa properti dinonaktifkan karena hanya dapat diatur untuk semua konfigurasi. Untuk mengedit properti ini, Anda harus memilih Semua Konfigurasi.

   

Mengubah jumlah instans peran

Untuk meningkatkan performa layanan awan, Anda dapat mengubah jumlah instans peran yang berjalan, berdasarkan jumlah pengguna atau beban yang diharapkan untuk peran tertentu. Komputer virtual terpisah dibuat untuk setiap instans peran saat layanan cloud berjalan di Azure. Ini memengaruhi penagihan untuk penyebaran layanan cloud ini. Untuk informasi selengkapnya tentang penagihan, lihat Memahami tagihan Anda untuk Microsoft Azure.

1. Membuat atau membuka proyek layanan cloud Azure di Visual Studio.

2. Di Penjelajah Solusi, perluas simpul proyek. Di bawah simpul Peran , klik kanan peran yang ingin Anda perbarui, dan, dari menu konteks, pilih Properti.

   

3. Pilih tab Konfigurasi.

   

4. Di daftar Konfigurasi Layanan , pilih konfigurasi layanan yang ingin Anda perbarui.

   

5. Dalam kotak teks Jumlah instans , masukkan jumlah instans yang ingin Anda mulai untuk peran ini. Setiap instans berjalan pada komputer virtual terpisah saat Anda menerbitkan layanan cloud ke Azure.

   

6. Dari Visual Studio, toolbar, pilih Simpan.

Mengelola string koneksi untuk akun penyimpanan

Anda dapat menambahkan, menghapus, atau mengubah string koneksi untuk konfigurasi layanan Anda. Misalnya, Anda mungkin menginginkan string koneksi lokal untuk konfigurasi layanan lokal yang memiliki nilai UseDevelopmentStorage=true. Anda mungkin juga ingin mengonfigurasi konfigurasi layanan cloud yang menggunakan akun penyimpanan di Azure.

Peringatan

Saat Anda memasukkan informasi kunci akun penyimpanan Azure untuk string koneksi akun penyimpanan, informasi ini disimpan secara lokal dalam file konfigurasi layanan. Namun, informasi ini saat ini tidak disimpan sebagai teks terenkripsi.

Dengan menggunakan nilai yang berbeda untuk setiap konfigurasi layanan, Anda tidak perlu menggunakan string koneksi yang berbeda di layanan awan Anda atau memodifikasi kode anda saat menerbitkan layanan cloud ke Azure. Anda dapat menggunakan nama yang sama untuk string koneksi dalam kode Anda dan nilainya berbeda, berdasarkan konfigurasi layanan yang Anda pilih saat membuat layanan awan atau saat menerbitkannya.

1. Membuat atau membuka proyek layanan cloud Azure di Visual Studio.

2. Di Penjelajah Solusi, perluas simpul proyek. Di bawah simpul Peran , klik kanan peran yang ingin Anda perbarui, dan, dari menu konteks, pilih Properti.

   

3. Pilih tab Pengaturan.

   

4. Di daftar Konfigurasi Layanan , pilih konfigurasi layanan yang ingin Anda perbarui.

   

5. Untuk menambahkan string koneksi, pilih Tambahkan Pengaturan.

   

6. Setelah pengaturan baru ditambahkan ke daftar, perbarui baris dalam daftar dengan informasi yang diperlukan.

   

   • Nama - Masukkan nama yang ingin Anda gunakan untuk string koneksi.
   • Jenis - Pilih String Koneksi dari daftar drop-down.
   • Nilai - Anda dapat memasukkan string koneksi langsung ke sel Nilai , atau memilih elipsis (...) untuk bekerja dalam dialog Buat String Koneksi Penyimpanan .

7. Dalam dialog Buat String Koneksi Penyimpanan , pilih opsi untuk Sambungkan menggunakan. Kemudian ikuti instruksi untuk opsi yang Anda pilih:

   • Microsoft Azure Storage Emulator - Jika Anda memilih opsi ini, pengaturan yang tersisa pada dialog dinonaktifkan karena hanya berlaku untuk Azure. PilihOK.
   • Langganan Anda - Jika Anda memilih opsi ini, gunakan daftar dropdown untuk memilih dan masuk ke akun Microsoft, atau menambahkan akun Microsoft. Pilih langganan Azure dan akun penyimpanan. PilihOK.
   • Kredensial yang dimasukkan secara manual - Masukkan nama akun penyimpanan, dan kunci primer atau kedua. Pilih opsi untuk Koneksi (HTTPS direkomendasikan untuk sebagian besar skenario.) Pilih OK.

8. Untuk menghapus string koneksi, pilih string koneksi, lalu pilih Hapus Pengaturan.

9. Dari Visual Studio, toolbar, pilih Simpan.

Mengakses string koneksi secara terprogram

Langkah-langkah berikut menunjukkan cara mengakses string koneksi secara terprogram menggunakan C#.

1. Tambahkan yang berikut ini menggunakan direktif ke file C# tempat Anda akan menggunakan pengaturan :

   using Microsoft.WindowsAzure;
   using Microsoft.WindowsAzure.Storage;
   using Microsoft.WindowsAzure.ServiceRuntime;
   

2. Kode berikut mengilustrasikan contoh cara mengakses string koneksi. Ganti tempat <penampung ConnectionStringName> dengan nilai yang sesuai.

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

Menambahkan pengaturan kustom untuk digunakan di layanan cloud Azure Anda

Pengaturan kustom dalam file konfigurasi layanan memungkinkan Anda menambahkan nama dan nilai untuk string untuk konfigurasi layanan tertentu. Anda dapat memilih untuk menggunakan pengaturan ini untuk mengonfigurasi fitur di layanan awan Anda dengan membaca nilai pengaturan dan menggunakan nilai ini untuk mengontrol logika dalam kode Anda. Anda dapat mengubah nilai konfigurasi layanan ini tanpa harus membangun kembali paket layanan Anda atau saat layanan awan Anda berjalan. Kode Anda dapat memeriksa pemberitahuan kapan pengaturan berubah. Lihat RoleEnvironment.Changing Event.

Anda dapat menambahkan, menghapus, atau mengubah pengaturan kustom untuk konfigurasi layanan Anda. Anda mungkin menginginkan nilai yang berbeda untuk string ini untuk konfigurasi layanan yang berbeda.

Dengan menggunakan nilai yang berbeda untuk setiap konfigurasi layanan, Anda tidak perlu menggunakan string yang berbeda di layanan awan Atau mengubah kode saat menerbitkan layanan cloud ke Azure. Anda dapat menggunakan nama yang sama untuk string dalam kode Anda dan nilainya berbeda, berdasarkan konfigurasi layanan yang Anda pilih saat membuat layanan cloud atau saat menerbitkannya.

1. Membuat atau membuka proyek layanan cloud Azure di Visual Studio.

2. Di Penjelajah Solusi, perluas simpul proyek. Di bawah simpul Peran , klik kanan peran yang ingin Anda perbarui, dan, dari menu konteks, pilih Properti.

   

3. Pilih tab Pengaturan.

   

4. Di daftar Konfigurasi Layanan , pilih konfigurasi layanan yang ingin Anda perbarui.

   

5. Untuk menambahkan pengaturan kustom, pilih Tambahkan Pengaturan.

   

6. Setelah pengaturan baru ditambahkan ke daftar, perbarui baris dalam daftar dengan informasi yang diperlukan.

   

   • Nama - Masukkan nama pengaturan.
   • Jenis - Pilih String dari daftar drop-down.
   • Nilai - Masukkan nilai pengaturan. Anda dapat memasukkan nilai langsung ke sel Nilai , atau memilih elipsis (...) untuk memasukkan nilai dalam dialog Edit String .

7. Untuk menghapus pengaturan kustom, pilih pengaturan, lalu pilih Hapus Pengaturan.

8. Dari Visual Studio, toolbar, pilih Simpan.

Mengakses nilai pengaturan kustom secara terprogram

Langkah-langkah berikut menunjukkan cara mengakses pengaturan kustom secara terprogram menggunakan C#.

1. Tambahkan yang berikut ini menggunakan direktif ke file C# tempat Anda akan menggunakan pengaturan :

   using Microsoft.WindowsAzure;
   using Microsoft.WindowsAzure.Storage;
   using Microsoft.WindowsAzure.ServiceRuntime;
   

2. Kode berikut mengilustrasikan contoh cara mengakses pengaturan kustom. Ganti tempat penampung <SettingName> dengan nilai yang sesuai.

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

Mengelola penyimpanan lokal untuk setiap instans peran

Anda dapat menambahkan penyimpanan sistem file lokal untuk setiap instans peran. Data yang disimpan dalam penyimpanan tersebut tidak dapat diakses oleh instans peran lain tempat data disimpan, atau oleh peran lain.

1. Membuat atau membuka proyek layanan cloud Azure di Visual Studio.

2. Di Penjelajah Solusi, perluas simpul proyek. Di bawah simpul Peran , klik kanan peran yang ingin Anda perbarui, dan, dari menu konteks, pilih Properti.

   

3. Pilih tab Penyimpanan Lokal .

   

4. Dalam daftar Konfigurasi Layanan , pastikan bahwa Semua Konfigurasi dipilih sebagai pengaturan penyimpanan lokal berlaku untuk semua konfigurasi layanan. Nilai lainnya menghasilkan semua bidang input pada halaman yang dinonaktifkan.

   

5. Untuk menambahkan entri penyimpanan lokal, pilih Tambahkan Penyimpanan Lokal.

   

6. Setelah entri penyimpanan lokal baru ditambahkan ke daftar, perbarui baris dalam daftar dengan informasi yang diperlukan.

   

   • Nama - Masukkan nama yang ingin Anda gunakan untuk penyimpanan lokal baru.
   • Ukuran (MB) - Masukkan ukuran dalam MB yang Anda butuhkan untuk penyimpanan lokal baru.
   • Bersihkan pada daur ulang peran - Pilih opsi ini untuk menghapus data di penyimpanan lokal baru saat komputer virtual untuk peran didaur ulang.

7. Untuk menghapus entri penyimpanan lokal, pilih entri, lalu pilih Hapus Penyimpanan Lokal.

8. Dari Visual Studio, toolbar, pilih Simpan.

Mengakses penyimpanan lokal secara terprogram

Bagian ini menggambarkan cara mengakses penyimpanan lokal secara terprogram menggunakan C# dengan menulis file MyLocalStorageTest.txtteks pengujian .

Menulis file teks ke penyimpanan lokal

Kode berikut menunjukkan contoh cara menulis file teks ke penyimpanan lokal. Ganti tempat <penampung LocalStorageName> dengan nilai yang sesuai.

// 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);
}

Menemukan file yang ditulis ke penyimpanan lokal

Untuk melihat file yang dibuat oleh kode di bagian sebelumnya, ikuti langkah-langkah berikut:

1. Di area pemberitahuan Windows, klik kanan ikon Azure, dan, dari menu konteks, pilih Tampilkan UI Emulator Komputasi.

   

2. Pilih peran web.

   

3. Pada menu Emulator Microsoft Azure Compute , pilih Alat>Buka penyimpanan lokal.

   

4. Saat jendela Windows Explorer terbuka, masukkan 'MyLocalStorageTest.txt'' ke dalam kotak teks Pencarian , dan pilih Enter untuk memulai pencarian.

Langkah berikutnya

Pelajari selengkapnya tentang proyek Azure di Visual Studio dengan membaca Mengonfigurasi Proyek Azure. Pelajari selengkapnya tentang skema layanan cloud dengan membaca Referensi Skema.