Latihan - Menyiapkan lingkungan Azure DevOps Anda

  • 8 menit

Di unit ini, Anda akan memastikan bahwa organisasi Microsoft Azure DevOps Anda disiapkan untuk menyelesaikan sisa modul ini.

Untuk melakukannya, Anda akan:

  • Siapkan proyek Azure DevOps untuk modul ini.
  • Di Azure Boards, pindahkan item pekerjaan untuk modul ini ke kolom Melakukan.
  • Pastikan proyek Anda disiapkan secara lokal sehingga Anda dapat mendorong perubahan ke alur.

Dapatkan proyek Azure DevOps

Di sini, Anda akan memastikan bahwa organisasi Azure DevOps Anda disiapkan untuk menyelesaikan sisa modul ini. Anda akan melakukan ini dengan menjalankan templat yang membuat proyek untuk Anda di Azure DevOps.

Modul dalam jalur pembelajaran ini membentuk perkembangan, di mana Anda mengikuti tim web Tailspin melalui perjalanan DevOps mereka. Untuk tujuan pembelajaran, setiap modul memiliki proyek Azure DevOps terkait.

Jalankan template

Untuk menyiapkan semuanya di organisasi Azure DevOps, Anda akan menjalankan templat.

Jalankan template

Dari situs generator demo Azure DevOps, untuk menjalankan templat, lakukan langkah-langkah ini.

  1. Pilih Masuk dan terima persyaratan penggunaan.

  2. Dari laman Buat Proyek Baru, pilih organisasi Azure DevOps Anda, dan masukkan nama proyek. Misalnya, masukkan Space Game - web - Dependensi.

  3. Pilih Ya, saya ingin fork repositori ini, lalu pilih Otorisasi. Jika jendela muncul, otorisasi akses ke akun GitHub Anda.

    Penting

    Anda perlu memilih opsi ini agar templat tersambung ke repositori GitHub Anda. Pilih opsi ini bahkan jika Anda telah membuat fork proyek situs web Space Game. Templat menggunakan fork Anda yang sudah ada.

  4. Pilih Buat Proyek.

    Cuplikan layar dari Azure DevOps Demo Generator yang menunjukkan cara membuat proyek baru.

    Dibutuhkan beberapa saat agar templat berjalan.

  5. Untuk masuk ke proyek Anda di Azure DevOps, pilih Navigasi ke proyek saat proyek selesai dibangun.

Penting

Halaman Bersihkan lingkungan Azure DevOps Anda dalam modul ini berisi langkah-langkah pembersihan penting. Pembersihan membantu memastikan bahwa Anda tidak kehabisan menit build gratis. Pastikan untuk melakukan langkah-langkah pembersihan meskipun Anda tidak menyelesaikan modul ini.

Atur visibilitas proyek Anda

Awalnya, fork repositori Space Game Anda di GitHub diatur ke publik saat proyek yang dibuat oleh templat Azure DevOps diatur ke privat. Repositori publik di GitHub dapat diakses oleh siapa saja, sementara repositori privat hanya dapat diakses oleh Anda dan orang-orang yang Anda pilih untuk membagikannya. Demikian pula, di Azure DevOps, proyek publik menyediakan akses baca-saja ke pengguna yang tidak diautentikasi, sementara proyek privat mengharuskan pengguna untuk diberikan akses dan diautentikasi untuk mengakses layanan.

Saat ini, tidak perlu memodifikasi salah satu pengaturan ini untuk tujuan modul ini. Namun, untuk proyek pribadi Anda, Anda harus menentukan visibilitas dan akses yang ingin Anda berikan kepada orang lain. Misalnya, jika proyek Anda sumber terbuka, Anda dapat memilih untuk membuat repositori GitHub dan proyek Azure DevOps Anda menjadi publik. Jika proyek Anda bersifat kepemilikan, Anda biasanya akan membuat repositori GitHub dan proyek Azure DevOps Anda privat.

Nantinya, Anda mungkin menemukan sumber daya berikut yang berguna dalam menentukan opsi mana yang terbaik untuk proyek Anda:

Memindahkan item kerja ke Melakukan

Di bagian ini, Anda akan menetapkan item kerja untuk diri Anda sendiri yang berkaitan dengan modul ini di Azure Boards. Anda juga akan memindahkan item pekerjaan ke status Melakukan. Dalam praktiknya, Anda dan tim Anda akan membuat item pekerjaan di awal setiap sprint, atau perulangan kerja.

Menetapkan pekerjaan dengan cara ini memberi Anda daftar periksa dari mana harus bekerja. Ini memberi orang lain di tim Anda visibilitas tentang apa yang sedang Anda kerjakan dan berapa banyak pekerjaan yang tersisa. Ini juga membantu tim memberlakukan batas kerja yang sedang berlangsung sehingga tim tidak mengambil terlalu banyak pekerjaan pada satu waktu.

Ingatlah bahwa tim telah menyelesaikan tujuh masalah teratas ini:

Cuplikan layar Azure Boards yang menunjukkan tumpukan masalah.

Catatan

Dalam organisasi Azure DevOps, item kerja diberi nomor secara berurutan. Dalam proyek Anda, nomor yang ditetapkan untuk setiap item pekerjaan mungkin tidak cocok dengan yang Anda lihat di sini.

Di sini, Anda akan memindahkan item keenam, Memindahkan data model ke paketnya sendiri ke kolom Lakukan , dan menetapkan diri Anda ke item kerja.

Ingat bahwa Memindahkan data model ke paketnya sendiri berkaitan dengan pemindahan kode yang dapat digunakan kembali ke paket NuGet sendiri, sehingga paket dapat dibagikan di antara beberapa aplikasi.

Cuplikan layar Azure Boards yang memperlihatkan detail item kerja untuk data model Pindahkan ke masalah paketnya sendiri.

Untuk menyiapkan item kerja:

  1. Dari Azure DevOps, buka Papan, dan pilih Papan dari menu.

    Cuplikan layar Azure DevOps yang menunjukkan lokasi menu Papan.

  2. Dari item Pindahkan data model ke paket kerjanya sendiri, pilih panah bawah di bagian bawah kartu, lalu tetapkan item kerja untuk diri Anda sendiri.

    Cuplikan layar Azure Boards yang menunjukkan lokasi panah bawah.

  3. Pindahkan item pekerjaan dari Akan Dilakukan ke kolom Melakukan.

    Cuplikan layar Azure Boards, menunjukkan kartu di kolom Melakukan.

Di akhir modul ini, setelah Anda menyelesaikan tugas, Anda akan memindahkan kartu ke kolom Selesai.

Menjalankan proyek secara lokal

Di sini, Anda memuat proyek Space Game di Visual Studio Code, mengonfigurasi Git, mengkloning repositori Anda secara lokal, dan menyetel remote upstram sehingga Anda dapat mengunduh kode starter.

Catatan

Jika Anda sudah menyiapkan proyek mslearn-tailspin-spacegame-web secara lokal, Anda dapat pindah ke bagian berikutnya.

Buka terminal terintegrasi

Visual Studio Code hadir dengan terminal terintegrasi, sehingga Anda dapat mengedit file dan bekerja dari baris perintah semua dalam satu tempat.

  1. Memulai Visual Studio Code.

  2. Pada menu Tampilan, pilih Terminal.

  3. Pada daftar drop-down, pilih bash. Jika Anda terbiasa dengan shell Unix lain yang lebih suka Anda gunakan, seperti Zsh, pilih shell tersebut sebagai gantinya.

    Cuplikan layar Visual Studio Code yang menunjukkan lokasi shell Bash.

    Jendela terminal memungkinkan Anda memilih shell apa pun yang diinstal pada sistem Anda, seperti Bash, Zsh, dan PowerShell.

    Di sini Anda akan menggunakan Bash. Git untuk Windows menyediakan Git Bash, yang memudahkan menjalankan perintah Git.

    Catatan

    Di Windows, jika Anda tidak melihat Git Bash terdaftar sebagai opsi, pastikan Anda telah menginstal Git, lalu memulai ulang Visual Studio Code.

  4. Jalankan perintah cd untuk menavigasikan ke direktori tempat Anda ingin bekerja, seperti direktori beranda Anda (~). Anda dapat memilih direktori lain jika Anda mau.

    cd ~

Konfigurasikan Git

Jika Anda baru mengenal Git dan GitHub, Anda harus menjalankan beberapa perintah terlebih dahulu untuk mengaitkan identitas Anda dengan Git dan mengautentikasi dengan GitHub.

Menyiapkan Git menjelaskan proses secara lebih rinci.

Setidaknya, Anda akan perlu menyelesaikan langkah-langkah berikut. Jalankan perintah ini dari terminal terintegrasi:

  1. Atur nama pengguna Anda.
  2. Atur alamat email penerapan Anda.
  3. Tembolokan kata sandi GitHub Anda.

Catatan

Jika Anda sudah menggunakan autentikasi dua faktor dengan GitHub, buat token akses pribadi dan gunakan token Anda sebagai pengganti kata sandi Anda saat diminta nanti.

Perlakukan token akses Anda seperti kata sandi. Simpan di tempat yang aman.

Siapkan proyek Anda di Visual Studio Code

Di bagian ini, Anda mengkloning fork secara lokal sehingga Anda dapat membuat perubahan dan membangun konfigurasi alur Anda.

Catatan

Jika Anda menerima kesalahan tentang nama file yang terlalu panjang saat mengkloning repositori, coba kloning repositori di folder yang tidak memiliki nama panjang atau sangat bersarang.

Mengkloning fork Anda secara lokal

Anda sekarang memiliki salinan proyek web Space Game di akun GitHub Anda. Sekarang Anda akan mengunduh, atau mengkloning, salinan ke komputer Anda sehingga Anda dapat bekerja menggunakannya.

Kloning, seperti fork, adalah salinan repositori. Saat mengkloning repositori, Anda dapat membuat perubahan, memverifikasi bahwa repositori berfungsi seperti yang Anda harapkan, lalu mengunggah perubahan tersebut kembali ke GitHub. Anda juga dapat menyinkronkan salinan lokal Anda dengan perubahan yang telah dilakukan pengguna terautentikasi lainnya ke salinan repositori GitHub Anda.

Untuk mengkloning proyek web Space Game ke komputer Anda:

  1. Buka fork proyek web Space Game Anda (mslearn-tailspin-spacegame-web) di GitHub.

  2. Pilih Kode. Kemudian, dari tab HTTPS, pilih tombol di samping URL yang ditampilkan untuk menyalin URL ke clipboard Anda.

    Menemukan URL dan tombol salin dari repositori GitHub.

  3. Di Visual Studio Code, buka jendela terminal.

  4. Di terminal, pindah ke direktori tempat Anda ingin bekerja, seperti direktori beranda Anda (~). Anda dapat memilih direktori lain jika Anda mau.

    cd ~

  5. Jalankan perintah git clone. Ganti URL yang ditampilkan di sini dengan konten clipboard Anda:

    git clone https://github.com/your-name/mslearn-tailspin-spacegame-web.git

  6. Pindah ke direktori mslearn-tailspin-spacegame-web. Ini adalah direktori akar repositori Anda.

    cd mslearn-tailspin-spacegame-web

Mengatur remote upstram

Remote adalah repositori Git tempat anggota tim berkolaborasi (seperti repositori di GitHub). Di sini Anda mencantumkan remote Anda dan menambahkan remote yang menunjuk ke salinan repositori Microsoft sehingga Anda bisa mendapatkan kode sampel terbaru.

  1. Jalankan perintah git remote ini untuk membuat daftar remote Anda:

    git remote -v

    Anda melihat bahwa Anda memiliki akses ambil (unduh) dan dorong (unggah) ke repositori Anda:

    origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)

    Asal menentukan repositori Anda di GitHub. Saat Anda melakukan fork kode dari repositori lain, biasanya nama remote asli (yang Anda gunakan untuk fork) sebagai upstram.

  2. Jalankan perintah git remote add ini untuk membuat remote bernama upstram yang mengarah ke repositori Microsoft:

    git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git

  3. Jalankan git remote kedua kalinya untuk melihat perubahannya:

    git remote -v

    Anda melihat bahwa Anda masih memiliki akses ambil (unduh) dan dorong (unggah) ke repositori Anda. Sekarang Anda juga telah mengambil dan mendorong akses ke repositori Microsoft:

    origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (fetch)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (push)

Buka proyek di penjelajah file

Dalam Visual Studio Code, jendela terminal Anda mengarah ke direktori akar proyek web Space Game. Untuk melihat strukturnya dan bekerja dengan file, dari penjelajah file, Anda sekarang akan membuka proyek.

  1. Cara termudah untuk membuka proyek adalah membuka kembali Visual Studio Code di direktori saat ini. Untuk melakukannya, jalankan perintah berikut dari terminal terintegrasi:

    code -r .

    Anda melihat direktori dan pohon file di penjelajah file.

  2. Buka kembali terminal terintegrasi. Terminal menempatkan Anda di akar proyek web Anda.

Jika perintah code gagal, Anda perlu menambahkan Visual Studio Code ke PATH sistem Anda. Untuk melakukannya:

  1. Di Visual Studio Code, pilih F1 atau pilih Tampilkan>Palet Perintah untuk mengakses palet perintah.
  2. Di palet perintah, masukkan Perintah Shell: Instal perintah 'kode' di PATH.
  3. Ulangi prosedur sebelumnya untuk membuka proyek di penjelajah file.

Anda sekarang siap untuk bekerja dengan kode sumber Space Game dan konfigurasi Azure Pipelines dari lingkungan pengembangan lokal Anda.