Cara: Menjalankan SQL Server Unit Tests dari Team Foundation Build

Artikel
06/02/2023

Anda dapat menggunakan Team Foundation Build untuk menjalankan pengujian unit SQL Server Anda sebagai bagian dari uji verifikasi build (BVT). Anda dapat mengonfigurasi pengujian unit untuk menyebarkan database, menghasilkan data pengujian, lalu menjalankan pengujian yang dipilih. Jika Anda tidak terbiasa dengan Team Foundation Build, Anda harus meninjau informasi berikut sebelum mengikuti prosedur dalam topik ini:

Sebelum menggunakan prosedur ini, Anda harus terlebih dahulu mengonfigurasi lingkungan kerja dengan melakukan tugas berikut:

Instal Team Foundation Build dan kontrol versi Team Foundation. Anda mungkin harus menginstal Team Foundation Build dan kontrol versi Team Foundation di komputer yang berbeda.
Instal Utilitas Build Alat Data Microsoft SQL Server di komputer yang sama dengan Team Foundation Build. Untuk menginstal Utilitas Build SQL Server Data Tools, pertama-tama lakukan titik penginstalan administratif. Untuk informasi selengkapnya tentang titik penginstalan administratif, lihat Menginstal SQL Server Data Tools. Kemudian instal SSDTBuildUtilties.msi ke server build dari lokasi (/lokasi) yang digunakan untuk titik penginstalan administratif.
Sambungkan ke instans Visual Studio Team Foundation Server.

Setelah mengonfigurasi lingkungan kerja, Anda kemudian harus mengikuti langkah-langkah berikut:

Buat proyek database.
Mengimpor atau membuat skema dan objek untuk proyek database.
Konfigurasikan properti proyek database untuk build dan penyebaran.
Buat satu atau beberapa pengujian unit.
Tambahkan solusi yang berisi proyek database dan proyek pengujian unit ke kontrol versi, dan periksa semua file.

Prosedur dalam topik ini menjelaskan cara membuat definisi build untuk menjalankan pengujian unit Anda sebagai bagian dari eksekusi pengujian otomatis:

Mengonfigurasi Pengaturan Pengujian untuk Menjalankan Pengujian Unit Database pada Agen Build x64
Menetapkan Pengujian ke Kategori Pengujian (Opsional)
Mengubah Proyek Pengujian
Periksa solusi
Membuat Definisi Build
Jalankan Definisi Build Baru

Menjalankan Pengujian Unit SQL Server pada Komputer Build

Saat Anda menjalankan pengujian unit pada komputer build, pengujian unit mungkin tidak dapat menemukan file proyek database (.sqlproj). Masalah ini terjadi karena file app.config mereferensikan file tersebut dengan menggunakan jalur relatif. Selain itu, pengujian unit Anda mungkin gagal jika tidak dapat menemukan instans SQL Server yang ingin Anda gunakan untuk menjalankan pengujian unit. Masalah ini dapat terjadi jika string koneksi yang disimpan dalam file app.config tidak valid dari komputer build.

Untuk mengatasi masalah ini, Anda harus menentukan bagian ambil alih di app.config yang menimpa app.config dengan file konfigurasi yang khusus untuk lingkungan Team Foundation Build Anda. Untuk informasi selengkapnya, lihat Mengubah Proyek Pengujian, nanti dalam topik ini.

Mengonfigurasi Pengaturan Pengujian untuk Menjalankan Pengujian Unit SQL Server pada Agen Build x64

Sebelum dapat menjalankan pengujian unit pada agen build x64, Anda harus mengonfigurasi pengaturan pengujian untuk mengubah Platform Proses Host.

Untuk menentukan Platform Proses Host

Buka solusi yang berisi proyek pengujian yang ingin Anda konfigurasi pengaturannya.
Di Penjelajah Solusi, di folder Item Solusi, klik dua kali file Local.testsettings.

Kotak dialog Pengaturan Pengujian muncul.
Dalam daftar, klik Host.
Di panel detail, di Platform Proses Host, klik MSIL untuk mengonfigurasi pengujian Anda untuk dijalankan pada agen build x64.
Klik Terapkan.

Menetapkan Pengujian ke Kategori Pengujian (Opsional)

Biasanya, saat Anda membuat definisi build untuk menjalankan pengujian unit, Anda menentukan satu atau beberapa kategori pengujian. Semua pengujian dalam kategori yang ditentukan dijalankan saat build dijalankan.

Untuk menetapkan pengujian ke kategori pengujian

Buka jendela Uji Tampilan .
Pilih pengujian.
Di panel properti, klik Kategori Uji lalu klik elipsis (...) di kolom paling kanan.
Di jendela Kategori Pengujian, dalam kotak Tambahkan Kategori Baru, ketik nama untuk kategori pengujian baru Anda.
Klik Tambahkan lalu klik OK.

Kategori pengujian baru akan ditetapkan ke pengujian Anda dan akan tersedia untuk pengujian lain melalui properti mereka.

Mengubah Proyek Pengujian

Secara default, Team Foundation Build membuat file konfigurasi dari file app.config proyek saat membangun proyek pengujian unit. Jalur ke proyek database disimpan sebagai jalur relatif dalam file app.config. Jalur relatif yang berfungsi di Visual Studio tidak akan berfungsi karena Team Foundation Build menempatkan file bawaan di lokasi yang berbeda relatif terhadap tempat Anda menjalankan pengujian unit. Selain itu, file app.config Anda berisi string koneksi yang menentukan database yang ingin Anda uji. Anda juga memerlukan file app.config terpisah untuk Team Foundation Build jika pengujian unit harus terhubung ke database yang berbeda dari yang digunakan saat proyek pengujian dibuat. Dengan membuat modifikasi di prosedur berikutnya, Anda dapat menyiapkan proyek pengujian dan membangun server sehingga Team Foundation Build akan menggunakan konfigurasi yang berbeda.

Penting

Anda harus melakukan prosedur ini untuk setiap proyek pengujian (.vbproj atau .vsproj).

Untuk menentukan file app.config untuk Team Foundation Build

Di Penjelajah Solusi, klik kanan file app.config, dan klik Salin.
Klik kanan proyek pengujian dan klik Tempel.
Klik kanan file yang disebut Salin app.config, dan klik Ganti Nama.
Ketik BuildComputer.sqlunitttest.config dan tekan ENTER, di mana BuildComputer adalah nama komputer tempat agen build Anda berjalan.
Klik dua kali BuildComputer.sqlunitttest.config.

File konfigurasi terbuka di editor.

Ubah jalur relatif ke file .sqlproj dengan menambahkan tingkat folder untuk folder Sumber dan subfolder dengan nama yang sama dengan solusi. Misalnya, jika file konfigurasi awalnya berisi entri berikut:

<DatabaseDeployment DatabaseProjectFileName="..\..\..\Database3\Database3.sqlproj"      Configuration="Debug" />

Perbarui file sebagai berikut:

<DatabaseDeployment DatabaseProjectFileName="..\..\..\Database3\Database3.sqlproj"      Configuration="Debug" />

Setelah selesai, file BuildComputer.sqlunitttest.config Anda harus menyerupai contoh berikut untuk Visual Studio 2010:

<SqlUnitTesting_VS2010>  
    <DatabaseDeployment DatabaseProjectFileName="..\..\..\Database4\Database4.sqlproj"  
        Configuration="Debug" />  
    <DataGeneration ClearDatabase="true" />  
    <ExecutionContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False"  
        CommandTimeout="30" />  
    <PrivilegedContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False"  
        CommandTimeout="30" />  
</SqlUnitTesting_VS2010>

Atau, jika Anda menggunakan Visual Studio 2012:

<SqlUnitTesting_VS2012>  
        <DatabaseDeployment DatabaseProjectFileName="..\..\..\Database4\Database4.sqlproj"  
            Configuration="Debug" />  
        <DataGeneration ClearDatabase="true" />  
        <ExecutionContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False"  
            CommandTimeout="30" />  
        <PrivilegedContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False"  
            CommandTimeout="30" />  
    </SqlUnitTesting_VS2012>

Perbarui atribut ConnectionString untuk ExecutionContext dan PrivilegedContext untuk menentukan koneksi ke database target yang ingin Anda sebarkan.
Pada menu Berkas, klik Simpan Semua.
Di Penjelajah Solusi, klik dua kali app.config.
Di editor, untuk setiap simpul SqlUnitTesting_VSVersion>, tambahkan AllowConfigurationOverride="true".< Contohnya:
```
-- Update SqlUnitTesting_VS2010 node to:  
<SqlUnitTesting_VS2010 AllowConfigurationOverride="true">   

-- Update SqlUnitTesting_VS2012 node to:  
<SqlUnitTesting_VS2012 AllowConfigurationOverride="true">  
```
Dengan membuat perubahan ini, Anda mengizinkan Team Foundation Build untuk menggunakan file konfigurasi pengganti yang Anda buat.
Pada menu Berkas, klik Simpan Semua.

Selanjutnya, Anda harus memperbarui Local.testsettings untuk menyertakan file konfigurasi yang disesuaikan.

Untuk menyesuaikan Local.testsettings untuk menyebarkan file konfigurasi yang dikustomisasi

Di Penjelajah Solusi, klik dua kali Local.testsettings.

Kotak dialog Pengaturan Pengujian muncul.
Dalam daftar kategori, klik Penyebaran.
Pilih kotak centang Aktifkan penyebaran .
Klik Tambahkan File.
Dalam kotak dialog Tambahkan File Penyebaran, tentukan file BuildComputer.sqlunitttest.config yang Anda buat.
Klik Terapkan.
Klik Tutup.
Pada menu Berkas, klik Simpan Semua.

Selanjutnya, Anda memeriksa solusi Anda untuk kontrol versi.

Periksa solusi

Dalam prosedur ini, Anda memeriksa semua file solusi Anda. File-file ini mencakup file metadata pengujian solusi Anda, yang berisi asosiasi dan pengujian kategori pengujian Anda. Setiap kali Anda menambahkan, menghapus, mengatur ulang, atau mengubah konten pengujian, file metadata pengujian Anda secara otomatis diperbarui untuk mencerminkan perubahan ini.

Catatan

Prosedur ini menjelaskan langkah-langkah jika Anda menggunakan kontrol versi Team Foundation. Jika Anda menggunakan perangkat lunak kontrol versi yang berbeda, Anda harus mengikuti langkah-langkah yang sesuai untuk perangkat lunak Anda.

Untuk memeriksa solusi

Sambungkan ke komputer yang menjalankan Team Foundation Server.

Untuk informasi selengkapnya, lihat Menggunakan Penjelajah Kontrol Sumber.
Jika solusi Anda belum dalam kontrol sumber, tambahkan ke kontrol sumber.

Untuk informasi selengkapnya, lihat Menambahkan Proyek atau Solusi ke Kontrol Versi.
Klik Tampilkan, lalu klik Cek Masuk Tertunda.
Periksa semua file solusi Anda.

Untuk informasi selengkapnya, lihat Memeriksa Perubahan Tertunda.

Catatan

Anda mungkin memiliki proses tim tertentu yang mengatur bagaimana pengujian otomatis dibuat dan dikelola. Misalnya, proses mungkin mengharuskan Anda memverifikasi build secara lokal sebelum Anda memeriksa kode tersebut bersama dengan pengujian yang akan dijalankan di dalamnya.

Di Penjelajah Solusi, ikon gembok muncul di samping setiap file untuk menunjukkan bahwa ikon gembok dicek masuk. Untuk informasi selengkapnya, lihat Menampilkan File Kontrol Versi dan Properti Folder.

Pengujian Anda tersedia untuk Team Foundation Build. Anda sekarang dapat membuat definisi build yang berisi pengujian yang ingin Anda jalankan.

Membuat Definisi Build

Untuk membuat definisi build

Di Team Explorer, klik proyek tim Anda, klik kanan simpul Build , dan klik Definisi Build Baru.

Jendela Definisi Build Baru muncul.
Di Nama definisi build, ketik nama yang ingin Anda gunakan untuk definisi build.
Di bilah navigasi, klik Bangun Default.
Di Salin output build ke folder drop berikut (jalur UNC, seperti \\server\share), tentukan folder untuk berisi output build.

Anda dapat menentukan folder bersama di komputer lokal Anda atau lokasi jaringan mana pun yang akan memiliki izin proses build.
Di bilah navigasi, klik Proses.
Di grup Diperlukan, di Item yang akan Dibangun, klik tombol telusuri (...).
Dalam kotak dialog Editor Daftar Proyek Build, klik Tambahkan.
Tentukan file solusi (.sln) yang Anda tambahkan ke kontrol versi sebelumnya dalam panduan ini, dan klik OK.

Solusi muncul di daftar Proyek atau file solusi untuk membangun .
Klik OK.
Di grup Dasar, di Pengujian Otomatis, tentukan pengujian yang ingin Anda jalankan. Secara default, pengujian yang terkandung dalam file bernama *test*.dll dari solusi Anda akan dijalankan.
Pada menu File , klik Simpan ProjectName.

Anda telah membuat definisi build. Selanjutnya Anda memodifikasi proyek pengujian.

Jalankan Definisi Build Baru

Untuk menjalankan jenis build baru

Di Team Explorer, perluas simpul proyek tim, perluas simpul Build, klik kanan definisi build yang ingin Anda jalankan, lalu klik Antrean Build Baru.

Kotak dialog Queue Build {TeamProjectName} muncul dengan daftar semua jenis build yang ada.
Jika perlu, dalam Definisi build, klik definisi build baru Anda.
Konfirmasikan bahwa nilai dalam definisi Build, Build agent, dan Drop folder untuk bidang Build ini semuanya sesuai, lalu klik Antrean.

Tab Antrean build Explorer muncul. Untuk informasi selengkapnya, lihat Mengelola dan Menampilkan Build yang Selesai (Visual Studio 2010) atau Mengelola Build Anda di Build Explorer (Visual Studio 2012).

Lihat Juga

Menjalankan Pengujian Unit SQL Server
Membuat Definisi Build Dasar
Mengantrekan Build
Memantau Kemajuan Build yang Sedang Berjalan

Bagikan melalui