Bagikan melalui

Buat alur pertama Anda

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Ini adalah panduan langkah demi langkah untuk menggunakan Azure Pipelines untuk membangun aplikasi sampel dari repositori Git. Panduan ini menggunakan alur YAML yang dikonfigurasi dengan editor alur YAML.

Untuk informasi selengkapnya tentang berbagai bagian dalam alur YAML, lihat alur dalam skema YAML Azure Pipelines dan Menyesuaikan alur YAML Anda.

Jika Anda ingin menggunakan alur Klasik sebagai gantinya, lihat Menentukan alur Klasik Anda. Untuk panduan tentang menggunakan TFVC, lihat Membangun repositori TFVC.

Prasyarat - Azure DevOps

Pastikan Anda memiliki item berikut:

  • Akun GitHub tempat Anda dapat membuat repositori. Buat akun gratis.

  • Organisasi Azure DevOps. Buat akun gratis. Jika tim Anda sudah memilikinya, pastikan Anda adalah administrator proyek Azure DevOps yang ingin Anda gunakan.

  • Kemampuan untuk menjalankan pipeline pada agen yang di-hosting oleh Microsoft. Untuk menggunakan agen yang dihosting Microsoft, organisasi Azure DevOps Anda harus memiliki akses ke pekerjaan paralel yang dihosting Microsoft. Anda dapat membeli pekerjaan paralel atau Anda dapat meminta pemberian gratis.

Buat alur pertama Anda

Mendapatkan kode sampel Java

Untuk memulai, fork repositori berikut ke akun GitHub Anda.

https://github.com/MicrosoftDocs/pipelines-java

Membuat alur Java pertama Anda

  1. Di proyek Azure DevOps Anda, pilih Alur dari menu navigasi kiri.

  2. Pilih Alur baru atau Buat alur jika alur ini adalah yang pertama dalam proyek.

  3. Pada layar Di mana kode Anda , pilih GitHub.

  4. Anda dapat diarahkan ke GitHub untuk masuk. Jika demikian, masukkan informasi masuk GitHub Anda.

  5. Pada layar Pilih repositori , pilih repositori tempat aplikasi .NET Anda berada.

  6. Anda mungkin diarahkan ke GitHub untuk menginstal aplikasi Azure Pipelines. Jika demikian, pilih Setujui & instal.

  1. Azure Pipelines akan menganalisis repositori Anda dan merekomendasikan templat alur Maven .

  2. Ketika alur baru Anda muncul, tinjau YAML untuk melihat tindakan yang dilakukannya. Saat Anda siap, pilih Simpan dan jalankan.

  3. Anda diminta untuk meng-commit file baru azure-pipelines.yml ke repositori Anda. Setelah Anda puas dengan pesan, pilih Simpan dan jalankan lagi.

    Jika Anda ingin menonton pipeline Anda beraksi, pilih pekerjaan pembangunan.

    Anda baru saja membuat dan menjalankan alur yang secara otomatis kami buat untuk Anda, karena kode Anda tampaknya cocok untuk templat Maven .

    Anda sekarang memiliki alur YAML yang berfungsi (azure-pipelines.yml) di repositori Anda yang siap untuk Anda sesuaikan!

  4. Saat Anda siap untuk membuat perubahan pada pipeline Anda, pilih di halaman Pipelines lalu Edit file azure-pipelines.yml.

Pelajari selengkapnya tentang menggunakan Java di alur Anda.

Melihat dan mengelola pipeline Anda

Anda dapat melihat dan mengelola alur Anda dengan memilih Alur dari menu sebelah kiri untuk masuk ke halaman arahan alur.

Cuplikan layar halaman depan pipeline.

Dari halaman utama pipeline, Anda dapat melihat pipeline dan jalan pipeline, membuat dan mengimpor pipeline, mengelola keamanan, dan menelusuri rincian pipeline dan jalannya.

Pilih Terbaru untuk melihat alur yang baru-baru ini dijalankan (tampilan default), atau pilih Semua untuk melihat semua alur.

Cuplikan layar opsi untuk melihat jalannya alur di halaman utama alur.

Pilih alur untuk mengelola alur tersebut dan melihat pelaksanaan. Pilih nomor build untuk eksekusi terakhir untuk melihat hasil build tersebut, pilih nama cabang untuk melihat cabang untuk eksekusi tersebut, atau pilih menu konteks untuk menjalankan alur dan melakukan tindakan manajemen lainnya.

Cuplikan layar pipeline yang baru-baru ini dijalankan.

Pilih Jalankan untuk melihat semua proses pipeline. Anda dapat memfilter proses yang ditampilkan secara opsional.

Cuplikan layar alur kerja.

Pilih pelaksanaan alur untuk melihat informasi tentang pelaksanaan tersebut.

Anda dapat memilih untuk Mempertahankan atau Menghapus eksekusi dari menu konteks. Untuk informasi lebih lanjut tentang retensi hasil eksekusi, lihat Kebijakan retensi pembangunan dan penerbitan.

Cuplikan layar menu konteks jalankan alur.

Lihat detail alur

Halaman detail untuk alur memungkinkan Anda melihat dan mengelola alur tersebut.

Cuplikan layar halaman detail alur.

Pilih Edit untuk mengedit alur Anda. Untuk informasi selengkapnya, lihat editor alur YAML. Anda juga dapat mengedit pipeline dengan memodifikasi file azure-pipelines.yml langsung di repositori yang menghosting pipeline tersebut.

Lihat detail pelaksanaan penjaluran

Dari ringkasan eksekusi alur pengolahan, Anda dapat melihat status jalannya, baik saat berjalan maupun telah selesai.

Cuplikan layar ringkasan eksekusi alur.

Dari panel ringkasan, Anda dapat melihat detail pekerjaan dan tahap, mengunduh artefak, serta menavigasi ke komitmen tertaut, hasil pengujian, dan item kerja.

Pekerjaan dan tahapan

Panel pekerjaan menampilkan gambaran umum status tahapan dan pekerjaan Anda. Panel ini mungkin memiliki beberapa tab tergantung pada apakah alur Anda memiliki tahapan dan tugas-tugas, atau hanya tugas saja. Dalam contoh ini, alur memiliki dua tahap bernama Build dan Deploy. Anda dapat menelusuri paling detail langkah-langkah alur dengan memilih pekerjaan dari panel Tahapan atau Pekerjaan .

Cuplikan layar pekerjaan dan tahapan alur.

Pilih pekerjaan untuk melihat langkah-langkah untuk pekerjaan tersebut.

Cuplikan layar tugas pipa.

Dari tampilan langkah-langkah, Anda dapat meninjau status dan detail setiap langkah. Dari Opsi lainnya, Anda dapat mengatur ulang tanda waktu atau melihat log mentah dari semua langkah dalam rangkaian proses.

Cuplikan layar menu konten tugas alur.

Membatalkan dan menjalankan kembali alur

Jika alur kerja sedang berjalan, Anda dapat membatalkannya dengan memilih Batal. Jika eksekusi telah selesai, Anda dapat menjalankan kembali alur dengan memilih Jalankan baru.

Cuplikan layar pembatalan jalannya alur.

Menu tindakan eksekusi alur lainnya

Dari menu Tindakanlainnya, Anda dapat mengunduh log, menambahkan tag, mengedit alur, menghapus eksekusi, dan mengonfigurasi retensi untuk eksekusi.

Cuplikan layar halaman ringkasan eksekusi alur menu tindakan lainnya.

Catatan

Anda tidak dapat menghapus proses jika proses tersebut disimpan. Jika Anda tidak melihat Hapus, pilih Hentikan mempertahankan proses, lalu hapus proses tersebut. Jika Anda melihat Hapus dan Tampilkan rilis retensi, satu atau beberapa kebijakan retensi yang dikonfigurasi masih berlaku untuk eksekusi Anda. Pilih Tampilkan rilis retensi, hapus kebijakan (hanya kebijakan untuk proses yang dipilih yang akan dihapus), lalu hapus proses tersebut.

Menambahkan lencana status ke repositori Anda

Banyak pengembang ingin menunjukkan bahwa mereka menjaga kualitas kode mereka tetap tinggi dengan menampilkan lencana status di repositori mereka.

Lencana status menunjukkan alur Azure berhasil

Untuk menyalin lencana status ke clipboard Anda:

  1. Di Azure Pipelines, buka halaman Alur untuk melihat daftar alur. Pilih alur yang Anda buat di bagian sebelumnya.

  2. Pilih , lalu pilih Lencana Status.

  3. Pilih Lencana Status.

  4. Salin Markdown sampel dari bagian Sampel Markdown.

Sekarang dengan lencana Markdown di clipboard Anda, lakukan langkah-langkah berikut di GitHub:

  1. Buka daftar file dan pilih Readme.md. Pilih ikon pensil untuk mengedit.

  2. Tempelkan markdown lencana status di awal file.

  3. Komit perubahan ke cabang main.

  4. Perhatikan bahwa lencana status muncul dalam deskripsi repositori Anda.

Untuk mengonfigurasi akses anonim ke lencana untuk proyek privat:

  1. Navigasi ke Pengaturan Proyek di sudut kiri bawah halaman

  2. Buka tab Pengaturan di bawah Alur

  3. Alihkan penggeser Nonaktifkan akses anonim ke lencana pada bagian Umum

Catatan

Bahkan dalam proyek privat, akses lencana anonim diaktifkan secara default. Dengan akses lencana anonim diaktifkan, pengguna di luar organisasi Anda mungkin dapat mengkueri informasi seperti nama proyek, nama cabang, nama pekerjaan, dan status build melalui API status lencana.

Karena Anda baru saja mengubah Readme.md file di repositori ini, Azure Pipelines secara otomatis membangun kode Anda, sesuai dengan konfigurasi dalam azure-pipelines.yml file di akar repositori Anda. Kembali ke Azure Pipelines, amati bahwa eksekusi baru muncul. Setiap kali Anda mengedit, Azure Pipelines memulai eksekusi baru.

Kami akan menunjukkan kepada Anda cara menggunakan editor klasik di Azure DevOps Server 2019 untuk membuat build dan peluncuran yang mencetak "Hello world".

  1. Pergi ke Azure Repos. (Hub kode di navigasi sebelumnya)

    Repos file

  2. Jika proyek kosong, Anda akan disambut dengan layar untuk membantu Anda menambahkan kode ke repositori Anda. Pilih pilihan bawah untuk menginisialisasi repositori Anda dengan readme file:

    Menginisialisasi repositori

  1. Pergi ke Azure Repos.

  2. Tambahkan file.

    Pada tab File, dari simpul repositori, pilih opsi File Baru

  3. Dalam kotak dialog, beri nama file baru Anda dan buat.

    HelloWorld.ps1

  4. Salin dan tempel skrip ini.

    Write-Host "Hello world"

  5. Terapkan (simpan) file.

  1. Pilih Azure Pipelines, alur tersebut akan secara otomatis membawa Anda ke halaman Build .

    Menuju ke tab Builds

  2. Membuat alur baru.

    Pilih tombol tab build

    Untuk pengguna Azure DevOps baru, ini akan secara otomatis membawa Anda ke pengalaman pembuatan alur YAML. Untuk sampai ke editor klasik dan menyelesaikan panduan ini, Anda harus menonaktifkan fitur pratinjau untuk pengalaman pembuatan alur YAML Baru:

    Klik pengaturan di kanan atas layar dan klik fitur pratinjau

    Klik alih untuk menonaktifkan fitur pratinjau yaml

  3. Pastikan bahwa sumber, proyek, repositori, dan cabang default cocok dengan lokasi tempat Anda membuat skrip.

  4. Mulai dengan Pekerjaan kosong.

  5. Di sisi kiri, pilih Alur dan tentukan Nama apa pun yang ingin Anda gunakan. Untuk kumpulan Agen, pilih Hosted VS2017.

  6. Di sisi kiri, pilih tanda plus ( + ) untuk menambahkan tugas ke Pekerjaan 1. Di sisi kanan, pilih kategori Utilitas , pilih tugas PowerShell dari daftar, lalu pilih Tambahkan.

    Tambahkan tugas pembangunan ke proyek

  7. Di sisi kiri, pilih tugas skrip PowerShell baru Anda.

  8. Untuk argumen Jalur Skrip, pilih tombol untuk menjelajahi repositori Anda dan pilih skrip yang Anda buat.

    Pilih skrip Anda

  9. Pilih Simpan & Antre, lalu pilih Simpan.

  1. Pada tab Tugas , pilih tanda plus ( + ) untuk menambahkan tugas ke Pekerjaan 1.

  2. Pilih kategori Utilitas, pilih tugas Publikasikan Artefak Build, lalu pilih Tambahkan.

    Menambahkan tugas publikasi artefak

    Jalur untuk menerbitkan: Pilih tombol untuk menelusuri dan memilih skrip yang Anda buat.

    Nama artefak: Masukkan drop.

    Lokasi penerbitan artefak: Pilih Azure Artifacts/TFS.

  1. Pilih Simpan & antrean, lalu pilih Simpan & antrean.

  2. Pada kotak dialog, pilih Simpan & antrean sekali lagi.

    Ini mengantrekan build baru pada agen yang dihosting Microsoft.

  3. Anda melihat tautan ke build baru di bagian atas halaman.

    konsol pembangun

    Pilih tautan untuk menonton pembaruan baru saat sedang berlangsung. Setelah agen dialokasikan, Anda akan mulai melihat log build secara langsung. Perhatikan bahwa skrip PowerShell dijalankan sebagai bagian dari build, dan bahwa "Hello world" dicetak ke konsol.

    Tonton di konsol pembangunan

  4. Buka ringkasan build. Pada tab Artefak build, perhatikan bahwa skrip tersebut diterbitkan sebagai artefak.

    Buka konsol build untuk melihat artefak

Buka tugas PowerShell di konsol build

Sekarang Anda dapat melihat hasil perubahan Anda. Buka Azure Pipelines dan pilih Antrean. Perhatikan di bawah bagian Antrean atau berjalan bahwa build secara otomatis dipicu oleh perubahan yang Anda lakukan.

Membuat ringkasan log skrip PowerShell

  1. Pergi ke tab Pipelines, lalu pilih Rilis.

  2. Pilih tindakan untuk membuat alur Baru. Jika alur rilis sudah dibuat, pilih tanda plus ( + ) lalu pilih Buat alur rilis.

  3. Pilih tindakan untuk memulai dengan Pekerjaan kosong.

  4. Beri nama tahap QA.

  5. Di panel Artefak, pilih + Tambahkan dan tentukan Sumber (Alur build). Pilih Tambahkan.

  6. Pilih Petir untuk memicu Penyebaran Berkelanjutan lalu aktifkan Pemicu Penyebaran Berkelanjutan di sebelah kanan.

    Pilih petir untuk memicu penyebaran berkelanjutan

  7. Pilih tab Tugas dan pilih tahap QA Anda.

  8. Pilih tanda plus ( + ) untuk pekerjaan guna menambahkan tugas ke pekerjaan.

  9. Pada kotak dialog Tambahkan tugas , pilih Utilitas, temukan tugas PowerShell , lalu pilih tombol Tambahkan .

  10. Di sisi kiri, pilih tugas skrip PowerShell baru Anda.

  11. Untuk argumen Jalur Skrip, pilih tombol untuk menelusuri artefak Anda dan pilih skrip yang Anda buat.

  12. Tambahkan Argumen ini:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"

  13. Pada tab Alur, pilih tahap QA dan pilih Kloning.

    Mengkloning lingkungan rilis pada QA

  14. Ganti nama tahap Produksi yang dikloning.

  15. Ganti nama alur rilis Halo dunia.

    Mengganti nama alur rilis menjadi hello world

  16. Simpan alur rilis.

  1. Buat rilis baru.

    Membuat rilis - DevOps 2019 dan 2020

    Saat Buat rilis baru muncul, pilih Buat.

  2. Buka rilis yang Anda buat.

    rilis telah dibuat - DevOps 2019 dan 2020

  3. Lihat log untuk mendapatkan data real time tentang rilis.

    log rilis - DevOps 2019 dan 2020

log akhir langkah skrip rilis - DevOps 2019 dan 2020

Langkah berikutnya

Anda mempelajari cara membuat pipeline pertama Anda di Azure. Sekarang, Pelajari selengkapnya tentang mengonfigurasi alur dalam bahasa pilihan Anda:

Atau, Anda dapat melanjutkan untuk menyesuaikan alur yang Anda buat.

Untuk menjalankan alur Anda dalam kontainer, lihat Pekerjaan dalam Kontainer.

Untuk detail tentang membangun repositori GitHub, lihat Membangun repositori GitHub.

Untuk mempelajari cara menerbitkan Artefak Alur, lihat Menerbitkan Artefak Alur.

Untuk mengetahui apa lagi yang dapat Anda lakukan di alur YAML, lihat Referensi skema YAML.

Pembersihan

Jika Anda membuat alur pengujian apa pun, alur tersebut mudah dihapus saat Anda selesai dengan alur tersebut.

Untuk menghapus alur, navigasi ke halaman ringkasan untuk alur tersebut, dan pilih Hapus dari menu ... di kanan atas halaman. Ketik nama alur untuk mengonfirmasi, dan pilih Hapus.

Menghapus alur

FAQ

Di mana saya dapat membaca artikel tentang DevOps dan CI/CD?

Apa itu Integrasi Berkelanjutan?

Apa itu Pengiriman Berkelanjutan?

Apa itu DevOps?

Sistem kontrol versi apa yang dapat saya gunakan?

Saat siap menggunakan CI/CD untuk aplikasi, Anda dapat menggunakan sistem kontrol versi pilihan Anda:

Bagaimana cara mereplikasi alur?

Jika alur Anda memiliki pola yang ingin Anda replikasi di alur lain, kloning, ekspor, atau simpan sebagai templat.

semua-definisi-bangun-menu-tindakan-duplikasi-tindakan

Setelah mengkloning alur, Anda dapat membuat perubahan lalu menyimpannya.

Setelah mengekspor alur, Anda dapat mengimpornya dari tab Semua alur .

Setelah Anda membuat templat, anggota tim Anda dapat menggunakannya untuk mengikuti pola kerja di rangkaian kerja baru.

Petunjuk

Jika Anda menggunakan Editor Pembangun Baru, maka templat kustom Anda ditampilkan di bagian bawah daftar.

Bagaimana cara bekerja dengan draf?

Jika Anda mengedit alur build dan ingin menguji beberapa perubahan yang belum siap untuk produksi, Anda dapat menyimpannya sebagai draf.

simpan sebagai draf

Mengedit Draf - DevOps 2019 dan 2020

menerbitkan draf - DevOps 2019 dan 2020

Bagaimana cara menghapus pipeline?

Untuk menghapus alur, navigasi ke halaman ringkasan untuk alur tersebut, dan pilih Hapus dari menu ... di kanan atas halaman. Ketik nama alur untuk mengonfirmasi, dan pilih Hapus.

Apa lagi yang dapat saya lakukan saat mengantre build?

Anda dapat mengantre build secara otomatis atau secara manual.

Saat mengantre build secara manual, Anda dapat, untuk satu proses build:

Di mana saya dapat mempelajari selengkapnya tentang pengaturan alur?

Untuk mempelajari selengkapnya tentang pengaturan alur, lihat:

Bagaimana cara membuat alur build secara terprogram?

Referensi REST API: Membuat alur build

Catatan

Anda juga dapat mengelola build dan membangun alur dari baris perintah atau skrip menggunakan Azure Pipelines CLI.

  • Last updated on