Mengelola sumber daya VM di lingkungan

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

Lingkungan Azure Pipelines adalah sekelompok sumber daya yang dapat Anda targetkan dengan penyebaran dari alur. Lingkungan umum termasuk Pengembangan, Pengujian, atau Produksi.

Untuk menambahkan sumber daya komputer fisik atau virtual (VM) ke lingkungan, Anda menginstal agen pada komputer. Riwayat penyebaran lingkungan kemudian memberikan keterlacakan dari setiap komputer. Artikel ini menjelaskan cara menentukan dan menggunakan lingkungan untuk mengelola penyebaran di seluruh VM atau sumber daya server.

Catatan

Lingkungan Azure DevOps hanya tersedia untuk alur YAML. Untuk alur Klasik, grup penyebaran menyediakan fungsionalitas serupa.

Prasyarat

Untuk melakukan prosedur dalam artikel ini, Anda memerlukan prasyarat berikut:

Linux

• Akses ke repositori sumber tempat Anda dapat membuat alur. Untuk informasi selengkapnya, lihat Repositori sumber yang didukung.
• Peran administrator untuk kumpulan penyebaran, kumpulan server target yang tersedia untuk organisasi Azure DevOps Anda. Untuk informasi selengkapnya, lihat Mengatur keamanan grup penyebaran di Azure Pipelines.
• Izin Administrator Proyek atau Administrator Build izin di proyek Azure DevOps yang berisi lingkungan. Untuk informasi selengkapnya, lihat Keamanan sumber daya.
• Akses dan izin untuk mengunduh dan menjalankan skrip yang dapat dieksekusi pada VM yang ingin Anda sambungkan ke lingkungan.

Windows

• Akses ke repositori sumber tempat Anda dapat membuat alur. Untuk informasi selengkapnya, lihat Repositori sumber yang didukung.
• Peran administrator untuk kumpulan penyebaran atau sekumpulan server target yang tersedia untuk organisasi Azure DevOps Anda. Untuk informasi selengkapnya, lihat Mengatur keamanan grup penyebaran di Azure Pipelines.
• Izin Administrator Proyek atau Administrator Build izin di proyek Azure DevOps yang berisi lingkungan. Untuk informasi selengkapnya, lihat Keamanan sumber daya.
• Izin administrator Access dan PowerShell pada VM yang ingin Anda sambungkan ke lingkungan.

Membuat lingkungan dan menambahkan VM

Gunakan prosedur berikut untuk menambahkan VM atau komputer fisik ke lingkungan.

Membuat lingkungan dengan sumber daya VM

1. Di proyek Azure DevOps Anda, buka Pipeline>Lingkungan lalu pilih Buat lingkungan atau Lingkungan baru.

2. Pada layar Lingkungan baru , masukkan Nama dan Deskripsi opsional.

3. Di bawah Sumber Daya, pilih Komputer virtual, lalu pilih Berikutnya.

   

Menyalin skrip pendaftaran

Skrip agen untuk sumber daya VM seperti skrip untuk agen yang dihost sendiri, dan menggunakan perintah yang sama. Skrip mencakup Token Akses Pribadi (PAT) Azure DevOps untuk pengguna yang masuk, yang kedaluwarsa tiga jam setelah skrip dibuat. Anda hanya memerlukan PAT untuk menginstal agen.

Catatan

Untuk mengonfigurasi agen grup penyebaran, atau jika Anda mendapatkan kesalahan saat mendaftarkan sumber daya lingkungan VM, coba atur cakupan Akses PAT Anda ke Semua organisasi yang dapat diakses di Pengaturan> penggunaToken akses pribadi.

Linux

1. Pada layar Sumber daya komputer virtual , pilih Linux di bawah Sistem operasi.

2. Pilih ikon untuk menyalin skrip pendaftaran Linux.

   

Skrip ini sama untuk semua VM Linux yang ditambahkan ke lingkungan. Untuk informasi selengkapnya tentang menginstal skrip agen, lihat Agen Linux yang dihost sendiri.

Windows

1. Pada layar Sumber daya komputer virtual , pilih Windows di bawah Sistem operasi.

2. Pilih ikon untuk menyalin skrip pendaftaran PowerShell .

   

Skrip ini sama untuk semua VM Windows yang ditambahkan ke lingkungan. Untuk informasi selengkapnya tentang menginstal skrip agen, lihat Agen Windows yang dihost sendiri.

Menjalankan skrip pendaftaran yang disalin pada VM

1. Pilih Tutup. Lingkungan baru dibuat. Untuk menyalin skrip lagi, misalnya jika PAT Anda kedaluwarsa, pilih Tambahkan sumber daya lagi di halaman lingkungan.

   

2. Jalankan skrip yang disalin pada setiap VM target yang ingin Anda daftarkan dengan lingkungan.

   Catatan

   Jika VM sudah memiliki agen lain yang berjalan di atasnya, berikan nama unik bagi yang baru agent untuk mendaftar dengan lingkungan.

3. Setelah VM terdaftar, verifikasi bahwa VM tersebut muncul di tab Sumber Daya di halaman lingkungan Azure Pipelines.

   

Menggunakan lingkungan dalam alur YAML

Anda dapat menargetkan sumber daya VM dalam pekerjaan penyebaran YAML Anda dengan mereferensikan lingkungannya. Untuk informasi selengkapnya tentang pekerjaan penyebaran YAML, lihat Pekerjaan penyebaran dan definisi jobs.deployment dalam referensi skema alur YAML.

Pekerjaan penyebaran alur berikut hanya berjalan pada VM di VMEnv lingkungan.

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to VMenv
  environment: VMenv
  strategy:
     runOnce:
        deploy:   
          steps:
            - script: echo "Hello world"

Anda dapat menargetkan VM tertentu di lingkungan dengan menambahkan nama sumber daya VM ke nama lingkungan. Contoh berikut menyebarkan hanya ke sumber daya VM yang bernama RESOURCE-PC di lingkungan VMenv.

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to RESOURCE-PC in VMenv
  environment: VMenv.RESOURCE-PC  # only deploy to the VM resource named RESOURCE-PC
  strategy:
     runOnce:
        deploy:   
          steps:
            - script: echo "Hello world"

Anda juga dapat menggunakan sintaks lengkap kata kunci lingkungan penyebaran pekerjaan , dan menyebarkan ke VM lingkungan tertentu dengan mencantumkannya di resourceName.

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to RESOURCE-PC in VMenv with full syntax
  environment: 
    name: VMenv
    resourceType: virtualMachine
    resourceName: RESOURCE-PC # only deploy to the VM resource named RESOURCE-PC
  strategy:
    runOnce:
      deploy:   
          steps:
          - script: echo "Hello world"

Catatan

• Nilai resourceType seperti virtualMachine sensitif terhadap huruf besar/kecil. Casing yang salah tidak menghasilkan sumber daya yang cocok yang ditemukan.
• Jika Anda mencoba kembali tahap, penyebaran dimulai ulang pada semua VM yang ditentukan, bukan hanya pada target yang gagal.

Strategi penyebaran

Dalam pekerjaan penyebaran, Anda menerapkan penyebaran strategy untuk menentukan cara meluncurkan aplikasi Anda. VM mendukung kedua strategi runOnce dan rolling. Untuk informasi selengkapnya tentang strategi penyebaran dan kait siklus hidup, lihat Strategi penyebaran.

Permissions

Pertama kali Anda menjalankan alur yang menggunakan lingkungan, Anda harus memberikan izin untuk semua eksekusi alur untuk mengakses kumpulan agen dan lingkungan. Pilih simbol Menunggu di samping pekerjaan pada layar Ringkasan eksekusi alur, lalu pilih Izinkan untuk memberikan izin yang diperlukan.

Menambahkan dan mengelola tag

Tag adalah cara untuk menargetkan sekumpulan VM lingkungan tertentu untuk penyebaran. Saat Anda menentukan tags dalam environment kata kunci, alur hanya disebarkan ke VM lingkungan yang memiliki tag yang diterapkan.

Tidak ada batasan jumlah tag yang dapat Anda terapkan ke VM. Nama tag masing-masing dibatasi hingga 256 karakter.

Anda dapat menerapkan atau menghapus tag dengan memilih ikon Tindakan lainnya di samping VM pada tab Sumber Daya lingkungan.

Anda juga dapat menerapkan tag secara interaktif saat mendaftarkan skrip agen pada VM.

Jika Anda menentukan beberapa tag, alur hanya disebarkan ke VM yang menyertakan semua tag. Contoh berikut hanya menargetkan VM yang memiliki windows tag dan prod . Alur tidak disebarkan ke VM yang hanya memiliki satu atau tidak satu pun tag.

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to VM
  environment: 
    name: VMenv
    resourceType: virtualMachine
    tags: windows,prod # only deploy to VMs with both windows and prod tags
  strategy:
    runOnce:
      deploy:   
          steps:
          - script: echo "Hello world"

Lihat riwayat penyebaran

Pilih tab Penyebaran halaman lingkungan untuk keterlacakan lengkap penerapan dan item kerja dan riwayat penyebaran lintas alur per lingkungan dan sumber daya.

Menghapus VM dari lingkungan

Linux

Untuk menghapus VM dari lingkungan Linux, jalankan perintah berikut pada komputer.

./config.sh remove

Windows

Untuk menghapus VM dari lingkungan Windows, jalankan perintah berikut pada VM dari prompt perintah Administrator PowerShell di folder yang sama tempat Anda menjalankan perintah pendaftaran lingkungan.

./config.cmd remove

Konten terkait

• Membuat dan menargetkan lingkungan
• Lingkungan - Sumber daya Kubernetes
• Pekerjaan pendistribusian
• Referensi skema alur YAML