Menambahkan dan mengonfigurasi katalog dari GitHub atau Azure Repos

Artikel ini menjelaskan cara menambahkan dan mengonfigurasi katalog untuk pusat atau proyek pengembangan Azure Deployment Environments Anda.

Katalog membantu Anda menyediakan sekumpulan templat infrastruktur sebagai kode (IaC) yang dikumpulkan, yang dikenal sebagai definisi lingkungan bagi tim pengembangan Anda untuk membuat lingkungan. Anda dapat melampirkan repositori kontrol sumber Anda sendiri dari GitHub atau Azure DevOps sebagai katalog dan menentukan folder dengan definisi lingkungan Anda. Lingkungan Penyebaran memindai folder untuk definisi lingkungan dan membuatnya tersedia bagi tim pengembang untuk membuat lingkungan.

Untuk lebih mengamankan templat Anda, katalog dienkripsi; Lingkungan Penyebaran Azure mendukung enkripsi saat tidak aktif dengan kunci enkripsi yang dikelola platform, yang dikelola Microsoft untuk Azure Services.

• Untuk mempelajari cara menghosting repositori di GitHub, lihat Mulai menggunakan GitHub.
• Untuk mempelajari cara menghosting repositori Git dalam proyek Azure Repos, lihat Azure Repos.

Microsoft menawarkan katalog mulai cepat yang dapat Anda tambahkan ke pusat pengembangan atau proyek, dan katalog sampel yang dapat Anda gunakan sebagai repositori Anda. Anda juga dapat menggunakan repositori privat Anda sendiri, atau Anda dapat membuat fork dan menyesuaikan definisi lingkungan dalam katalog sampel.

Dalam artikel ini, Anda akan mempelajari cara:

1. Mengonfigurasi katalog tingkat proyek
2. Mengonfigurasi identitas terkelola
3. Menambahkan katalog dari Azure Repos atau GitHub
4. Memperbarui katalog
5. Menghapus katalog
6. Memecahkan masalah kesalahan sinkronisasi katalog

Mengonfigurasi katalog tingkat proyek

Melampirkan katalog di tingkat proyek memungkinkan teknisi platform untuk memberikan definisi lingkungan yang dikumpulkan yang khusus untuk tim pengembangan. Selain itu, ini memberdayakan prospek tim dev yang ditetapkan sebagai Admin Proyek untuk mengelola definisi lingkungan yang tersedia untuk tim mereka.

Insinyur platform memiliki kontrol penuh atas penggunaan katalog di tingkat proyek. Penggunaan katalog tingkat proyek harus diaktifkan di tingkat pusat dev sebelum katalog dapat ditambahkan ke proyek. Insinyur platform juga dapat mengonfigurasi jenis item katalog mana, seperti definisi lingkungan, yang dapat dikonsumsi di tingkat proyek.

Secara default, penggunaan katalog di tingkat proyek dinonaktifkan dan tidak ada jenis item katalog yang diaktifkan. Definisi lingkungan dari katalog tingkat proyek disinkronkan dan dapat digunakan dalam dua kondisi. Pertama, Anda harus mengaktifkan katalog berbasis proyek di tingkat pusat dev yang sesuai. Kedua, Anda harus mengaktifkan penggunaan definisi lingkungan untuk proyek.

Menambahkan katalog ke proyek

Anda harus mengaktifkan katalog tingkat proyek di tingkat pusat pengembangan sebelum Anda dapat menambahkan katalog ke proyek. Anda juga harus mengaktifkan penggunaan definisi lingkungan di tingkat proyek.

Untuk mengaktifkan penggunaan katalog tingkat proyek di tingkat pusat dev:

1. Di portal Azure, navigasikan ke pusat pengembangan Anda.

2. Di menu sebelah kiri, di bawah Pengaturan, pilih Konfigurasi.

   

3. Di panel Katalog tingkat proyek, pilih Aktifkan katalog per proyek, lalu pilih Terapkan.

   

Untuk mengaktifkan penggunaan definisi lingkungan dalam proyek:

1. Di portal Azure, navigasikan ke proyek Anda.

2. Di menu sebelah kiri, di bawah Pengaturan, pilih Katalog.

   

3. Pada halaman Katalog , pilih Izin item katalog.

   

4. Di panel Pengaturan item katalog, pilih Definisi lingkungan penyebaran Azure untuk mengaktifkan penggunaan definisi lingkungan di tingkat proyek.

   

Sekarang, Anda dapat menambahkan katalog ke proyek.

Untuk katalog yang menggunakan identitas terkelola atau Token Akses Pribadi (PAT) untuk autentikasi, Anda harus menetapkan identitas terkelola untuk proyek tersebut. Untuk katalog yang menggunakan PAT, Anda harus menyimpan PAT di brankas kunci dan memberikan akses identitas terkelola ke rahasia brankas kunci.

Mengonfigurasi identitas terkelola

Sebelum dapat melampirkan katalog ke pusat pengembangan atau proyek, Anda harus mengonfigurasi identitas terkelola, yang juga disebut Identitas Layanan Terkelola (MSI). Anda dapat melampirkan identitas terkelola yang ditetapkan sistem (MSI yang ditetapkan sistem) atau identitas terkelola yang ditetapkan pengguna (MSI yang ditetapkan pengguna). Anda kemudian menetapkan peran ke identitas terkelola untuk memungkinkan pusat dev atau proyek membuat jenis lingkungan dalam langganan Anda dan membaca proyek Azure Repos yang berisi repositori katalog.

Jika pusat pengembangan atau proyek Anda tidak memiliki MSI yang terlampir, ikuti langkah-langkah dalam Mengonfigurasi identitas terkelola untuk membuatnya dan menetapkan peran untuk identitas terkelola.

Untuk mempelajari selengkapnya tentang identitas terkelola, lihat Apa itu identitas terkelola untuk sumber daya Azure?

Menambahkan katalog

Anda dapat menambahkan katalog dari repositori Azure Repos atau repositori GitHub. Anda dapat memilih untuk mengautentikasi dengan menetapkan izin ke MSI atau dengan menggunakan PAT, yang Anda simpan di brankas kunci.

Pilih tab untuk jenis repositori dan autentikasi yang ingin Anda gunakan.

Repositori Azure Repos dengan MSI

Untuk menambahkan katalog, selesaikan tugas berikut:

• Tetapkan izin di Azure Repos untuk identitas terkelola.
• Tambahkan repositori Anda sebagai katalog.

Menetapkan izin di Azure Repos untuk identitas terkelola

Anda harus memberikan izin identitas terkelola ke repositori di Azure Repos.

1. Masuk ke Organisasi Azure DevOps Anda.

   Catatan

   Organisasi Azure DevOps Anda harus berada di direktori yang sama dengan langganan Azure yang berisi pusat pengembangan atau proyek Anda.

2. Pilih Pengaturan organisasi.

   

3. Pada halaman Gambaran Umum , pilih Pengguna.

   

4. Pada halaman Pengguna , pilih Tambahkan pengguna.

   

5. Selesaikan Tambahkan pengguna baru dengan memasukkan atau memilih informasi berikut, lalu pilih Tambahkan:

   Nama	Nilai
   Pengguna atau Perwakilan Layanan	Masukkan nama pusat dev atau proyek Anda. Saat Anda menggunakan MSI yang ditetapkan sistem, tentukan nama pusat dev atau proyek, bukan ID objek akun terkelola. Saat Anda menggunakan MSI yang ditetapkan pengguna, gunakan nama akun terkelola.
   Tingkat akses	Pilih Dasar.
   Tambahkan ke proyek	Pilih proyek yang berisi repositori Anda.
   Grup Azure DevOps	Pilih Pembaca Proyek.
   Mengirim undangan email (hanya untuk Pengguna)	Kosongkan kotak centang.

   

Menambahkan repositori Anda sebagai katalog

Lingkungan Penyebaran Azure mendukung melampirkan repositori Azure Repos dan repositori GitHub. Anda dapat menyimpan sekumpulan templat IaC yang dikumpulkan di repositori. Melampirkan repositori ke pusat pengembangan atau proyek sebagai katalog memberi tim pengembangan Anda akses ke templat dan memungkinkan mereka membuat lingkungan yang konsisten dengan cepat.

Langkah-langkah berikut memungkinkan Anda melampirkan repositori Azure Repos.

1. Di portal Azure, navigasikan ke pusat pengembangan atau proyek Anda.

2. Di menu sebelah kiri di bawah Konfigurasi lingkungan, pilih Katalog, lalu pilih Tambahkan.

   

3. Di Tambahkan katalog, masukkan informasi berikut, lalu pilih Tambahkan:

   Bidang	Nilai
   Nama	Masukkan nama untuk katalog.
   Lokasi katalog	Pilih Azure DevOps.
   Jenis autentikasi	Pilih Identitas Terkelola.
   Organisasi	Pilih organisasi Azure DevOps Anda.
   Proyek	Dari daftar proyek, pilih proyek yang menyimpan repositori.
   Reposition	Dari daftar repositori, pilih repositori yang ingin Anda tambahkan.
   Cabang	Pilih cabang.
   Jalur Folder	Dev Box mengambil daftar folder di cabang Anda. Pilih folder yang menyimpan templat IaC Anda.

   

4. Di Katalog untuk pusat pengembangan atau proyek, verifikasi bahwa katalog Anda muncul. Ketika koneksi berhasil, Status membaca Sinkronisasi berhasil. Menyambungkan ke katalog dapat memakan waktu beberapa menit untuk pertama kalinya.

Repositori Azure Repos dengan PAT

Untuk menambahkan katalog, selesaikan tugas berikut:

• Dapatkan URL kloning untuk repositori Azure Repos Anda.
• Membuat token akses pribadi (PAT).
• Simpan PAT sebagai rahasia brankas kunci di Azure Key Vault.
• Tambahkan repositori Anda sebagai katalog.

Mendapatkan URL kloning untuk repositori Azure Repos Anda

1. Buka halaman beranda koleksi tim Anda (misalnya, https://contoso-web-team.visualstudio.com), lalu pilih proyek Anda.

2. Dapatkan URL kloning repositori Azure Repos Git Anda.

3. Salin dan simpan URL.

Membuat token akses pribadi di Azure Repos

1. Buka beranda koleksi tim Anda (misalnya, https://contoso-web-team.visualstudio.com) dan pilih proyek Anda.

2. Buat PAT.

3. Salin dan simpan token yang dihasilkan untuk digunakan nanti.

Membuat Key Vault

Anda memerlukan Azure Key Vault untuk menyimpan PAT yang digunakan untuk memberikan akses Azure ke repositori Anda. Brankas kunci dapat mengontrol akses dengan kebijakan akses atau kontrol akses berbasis peran (RBAC). Jika Anda memiliki brankas kunci yang sudah ada, Anda dapat menggunakannya, tetapi Anda harus memeriksa apakah itu menggunakan kebijakan akses atau penetapan RBAC untuk mengontrol akses. Untuk bantuan dalam mengonfigurasi kebijakan akses untuk brankas kunci, lihat Menetapkan kebijakan akses Key Vault.

Gunakan langkah-langkah berikut untuk membuat brankas kunci RBAC:

1. Masuk ke portal Azure.

2. Dalam kotak Pencarian, masukkan Key Vault.

3. Dari daftar hasil, pilih Key Vault.

4. Pada halaman Key Vault, pilih Buat.

5. Pada tab Buat brankas kunci, berikan informasi berikut ini:

   Nama	Nilai
   Nama	Masukkan nama untuk brankas kunci.
   Langganan	Pilih langganan tempat Anda ingin membuat brankas kunci.
   Grup sumber daya	Gunakan grup sumber daya yang sudah ada atau pilih Buat baru dan masukkan nama untuk grup sumber daya.
   Location	Pilih lokasi atau wilayah tempat Anda ingin membuat brankas kunci.

   Biarkan opsi lain pada defaultnya.

6. Pada tab Kebijakan akses , pilih Kontrol akses berbasis peran Azure, lalu pilih Tinjau + buat.

7. Di tab Tinjau + buat, pilih Buat.

Jika kebijakan organisasi mengharuskan Anda untuk menjaga Key Vault Anda tetap privat dari internet, Anda dapat mengatur Key Vault untuk mengizinkan layanan Microsoft tepercaya melewati aturan firewall Anda.

Untuk mempelajari cara mengizinkan layanan Microsoft tepercaya melewati firewall, lihat Mengonfigurasi pengaturan jaringan Azure Key Vault.

Menyimpan token akses pribadi di brankas kunci

1. Di Key Vault, di menu sebelah kiri, pilih Rahasia.

2. Pada halaman Rahasia, pilih Hasilkan/Impor.

3. Pada halaman Buat rahasia :

   • Dalam kotak Nama , masukkan nama deskriptif untuk rahasia Anda.
   • Dalam kotak Nilai rahasia, tempelkan PAT yang Anda salin sebelumnya.
   • Pilih Buat.

Mendapatkan pengidentifikasi rahasia

Dapatkan jalur ke rahasia yang Anda buat di brankas kunci.

1. Di portal Azure, buka brankas kunci Anda.

2. Pada halaman brankas kunci, dari menu sebelah kiri, pilih Rahasia.

3. Pada halaman Rahasia , pilih rahasia yang Anda buat sebelumnya.

4. Pada halaman versi, pilih VERSI SAAT INI.

5. Pada halaman versi saat ini, untuk Pengidentifikasi rahasia, pilih salin.

Menambahkan repositori Anda sebagai katalog

1. Di portal Azure, buka pusat pengembangan atau proyek Anda.

2. Pastikan bahwa identitas yang melekat pada pusat dev atau proyek memiliki akses ke rahasia brankas kunci tempat token akses pribadi Anda disimpan.

3. Di menu sebelah kiri di bawah Konfigurasi lingkungan, pilih Katalog, lalu pilih Tambahkan.

4. Di Tambahkan katalog, masukkan informasi berikut, lalu pilih Tambahkan:

   Bidang	Nilai
   Nama	Masukkan nama untuk katalog.
   Lokasi katalog	Pilih Azure DevOps.
   Jenis autentikasi	Pilih Token Akses Pribadi.
   Organisasi	Pilih organisasi yang menghosting repositori katalog.
   Proyek	Pilih proyek yang menyimpan repositori katalog.
   Rep	Pilih repositori yang menyimpan katalog.
   Jalur Folder	Pilih folder yang menyimpan templat IaC Anda.
   Pengidentifikasi rahasia	Masukkan pengidentifikasi rahasia yang berisi PAT Anda untuk repositori. Saat Anda menyalin pengidentifikasi rahasia, string koneksi menyertakan pengidentifikasi versi di akhir, seperti dalam contoh ini: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. Menghapus pengidentifikasi versi memastikan bahwa Lingkungan Penyebaran mengambil versi terbaru rahasia dari brankas kunci. Jika PAT Anda kedaluwarsa, hanya brankas kunci yang perlu diperbarui. Contoh pengidentifikasi rahasia: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. Di Katalog, verifikasi bahwa katalog Anda muncul. Jika koneksi berhasil, Status Tersambung.

Aplikasi DevCenter Repositori GitHub

Untuk menambahkan katalog, selesaikan tugas berikut:

1. Menginstal dan mengonfigurasi aplikasi Microsoft Dev Center
2. Tetapkan izin di GitHub untuk repositori.
3. Tambahkan repositori Anda sebagai katalog.

Menginstal aplikasi Microsoft Dev Center

1. Masuk ke portal Azure.

2. Navigasi ke pusat pengembangan atau proyek Anda.

3. Di menu sebelah kiri di bawah Konfigurasi lingkungan, pilih Katalog, lalu pilih Tambahkan.

4. Di panel Tambahkan katalog , masukkan, atau pilih yang berikut ini:

   Bidang	Nilai
   Nama	Masukkan nama untuk katalog.
   Sumber katalog	Pilih GitHub.
   Jenis autentikasi	Pilih Aplikasi GitHub.

5. Untuk menginstal aplikasi Microsoft Dev Center, pilih konfigurasikan repositori Anda.

   

6. Jika Anda diminta untuk mengautentikasi ke GitHub, autentikasi.

7. Pada halaman Microsoft DevCenter , pilih Konfigurasikan.

   

8. Pilih organisasi GitHub yang berisi repositori yang ingin Anda tambahkan sebagai katalog. Anda harus menjadi pemilik organisasi untuk menginstal aplikasi ini.

   

9. Pada halaman Instal Microsoft DevCenter, pilih Hanya pilih repositori, pilih repositori yang ingin Anda tambahkan sebagai katalog, lalu pilih Instal.

   

   Anda dapat memilih beberapa repositori untuk ditambahkan sebagai katalog. Anda harus menambahkan setiap repositori sebagai katalog terpisah, seperti yang dijelaskan dalam Menambahkan repositori Anda sebagai katalog.

10. Pada halaman Microsoft DevCenter by Microsoft ingin izin ke: , tinjau izin yang diperlukan, lalu pilih Otorisasi Microsoft Dev Center.

    

Menambahkan repositori Anda sebagai katalog

1. Beralih kembali ke portal Microsoft Azure.

2. Di Tambahkan katalog, masukkan informasi berikut, lalu pilih Tambahkan:

   Bidang	Nilai
   Reposition	Pilih repositori yang ingin Anda tambahkan sebagai katalog.
   Cabang	Pilih cabang.
   Jalur Folder	Pilih folder yang berisi subfolder yang menyimpan definisi lingkungan Anda.

   

3. Di Katalog, verifikasi bahwa katalog Anda muncul. Ketika koneksi berhasil, Status membaca Sinkronisasi berhasil.

   

Repositori GitHub dengan PAT

Untuk menambahkan katalog, selesaikan tugas berikut:

• Dapatkan URL kloning repositori GitHub Anda.
• Buat token akses pribadi (PAT) di GitHub.
• Simpan PAT sebagai rahasia brankas kunci di Azure Key Vault.
• Tambahkan repositori Anda sebagai katalog.

Mendapatkan URL kloning repositori GitHub Anda

1. Buka halaman beranda repositori GitHub yang berisi definisi templat.

2. Dapatkan URL kloning repositori GitHub.

3. Salin dan simpan URL.

Membuat token akses pribadi di GitHub

Lingkungan Penyebaran Azure mendukung autentikasi ke repositori GitHub dengan menggunakan token klasik atau token halus. Dalam contoh ini, Anda membuat token halus.

1. Buka halaman beranda repositori GitHub yang berisi definisi templat.

2. Di sudut kanan atas GitHub, pilih gambar profil, lalu pilih Pengaturan.

3. Di bilah sisi kiri, pilih Pengaturan>pengembang Token akses pribadi Token> halus.

4. Klik Buat token baru.

5. Pada halaman Token akses pribadi menurun baru, berikan informasi berikut:

   Nama	Nilai
   Nama token	Masukkan nama deskriptif untuk token.
   Kedaluwarsa	Pilih periode kedaluwarsa token dalam hari.
   Keterangan	Masukkan deskripsi untuk token.
   Pemilik sumber daya	Pilih pemilik repositori.
   Akses repositori	Pilih Hanya pilih repositori.
   Pilih repositori	Pilih repositori yang berisi definisi lingkungan.
   Izin repositori	Perluas izin Repositori, dan untuk Konten, dari daftar Akses , pilih Baca kode.

   

6. Pilih Buat token.

7. Salin dan simpan token yang dihasilkan untuk digunakan nanti.

Penting

Saat bekerja dengan repositori privat yang disimpan dalam organisasi GitHub, Anda harus memastikan bahwa PAT GitHub dikonfigurasi untuk memberikan akses ke organisasi yang benar dan repositori di dalamnya.

• Token klasik dalam organisasi harus diotorisasi SSO ke organisasi tertentu setelah dibuat.
• Token halus harus memiliki pemilik token yang ditetapkan sebagai organisasi itu sendiri yang akan diotorisasi.

PAT yang salah dikonfigurasi dapat mengakibatkan kesalahan Repositori tidak ditemukan .

Membuat Key Vault

Anda memerlukan Azure Key Vault untuk menyimpan PAT yang digunakan untuk memberikan akses Azure ke repositori Anda. Brankas kunci dapat mengontrol akses dengan kebijakan akses atau kontrol akses berbasis peran (RBAC). Jika Anda memiliki brankas kunci yang sudah ada, Anda dapat menggunakannya, tetapi Anda harus memeriksa apakah itu menggunakan kebijakan akses atau penetapan RBAC untuk mengontrol akses. Untuk bantuan dalam mengonfigurasi kebijakan akses untuk brankas kunci, lihat Menetapkan kebijakan akses brankas kunci.

Gunakan langkah-langkah berikut untuk membuat brankas kunci RBAC:

1. Masuk ke portal Azure.

2. Dalam kotak Pencarian, masukkan brankas kunci.

3. Dari daftar hasil, pilih Key Vault.

4. Pada halaman Key Vault, pilih Buat.

5. Pada tab Buat brankas kunci, berikan informasi berikut ini:

   Nama	Nilai
   Nama	Masukkan nama untuk brankas kunci.
   Langganan	Pilih langganan tempat Anda ingin membuat brankas kunci.
   Grup sumber daya	Gunakan grup sumber daya yang sudah ada atau pilih Buat baru dan masukkan nama untuk grup sumber daya.
   Location	Pilih lokasi atau wilayah tempat Anda ingin membuat brankas kunci.

   Biarkan opsi lain pada defaultnya.

6. Pada tab Kebijakan akses , pilih Kontrol akses berbasis peran Azure, lalu pilih Tinjau + buat.

7. Di tab Tinjau + buat, pilih Buat.

Jika kebijakan organisasi mengharuskan Anda untuk menjaga Key Vault Anda tetap privat dari internet, Anda dapat mengatur Key Vault untuk mengizinkan layanan Microsoft tepercaya melewati aturan firewall Anda.

Untuk mempelajari cara mengizinkan layanan Microsoft tepercaya melewati firewall, lihat Mengonfigurasi pengaturan jaringan Azure Key Vault.

Menyimpan token akses pribadi di brankas kunci

1. Di Key Vault, di menu sebelah kiri, pilih Rahasia.

2. Pada halaman Rahasia, pilih Hasilkan/Impor.

3. Pada halaman Buat rahasia :

   • Dalam kotak Nama , masukkan nama deskriptif untuk rahasia Anda.
   • Dalam kotak Nilai rahasia, tempelkan PAT Anda.
   • Pilih Buat.

Mendapatkan pengidentifikasi rahasia

Dapatkan jalur ke rahasia yang Anda buat di brankas kunci.

1. Di portal Azure, buka brankas kunci Anda.

2. Pada halaman brankas kunci, dari menu sebelah kiri, pilih Rahasia.

3. Pada halaman Rahasia , pilih rahasia yang Anda buat sebelumnya.

4. Pada halaman versi, pilih VERSI SAAT INI.

5. Pada halaman versi saat ini, untuk Pengidentifikasi rahasia, pilih salin.

Menambahkan repositori Anda sebagai katalog

1. Di portal Azure, buka pusat pengembangan atau proyek Anda.

2. Pastikan bahwa identitas terkelola yang dilampirkan ke pusat dev atau proyek memiliki akses ke rahasia brankas kunci tempat token akses pribadi Anda disimpan.

3. Di menu sebelah kiri di bawah Konfigurasi lingkungan, pilih Katalog, lalu pilih Tambahkan.

4. Di Tambahkan katalog, masukkan informasi berikut, lalu pilih Tambahkan.

   Bidang	Nilai
   Nama	Masukkan nama untuk katalog.
   Lokasi katalog	Pilih GitHub.
   Reposition	Masukkan atau tempel url kloning untuk repositori GitHub atau repositori Azure Repos Anda. Contoh katalog sampel: https://github.com/Azure/deployment-environments.git
   Cabang	Masukkan cabang repositori yang akan disambungkan. Contoh katalog sampel: main
   Jalur Folder	Masukkan jalur folder relatif terhadap URI kloning yang berisi subfolder yang menyimpan definisi lingkungan Anda. Jalur folder adalah untuk folder dengan subfolder yang berisi file lingkungan definisi lingkungan, bukan untuk folder dengan file lingkungan definisi lingkungan itu sendiri. Gambar berikut menunjukkan contoh struktur folder katalog. Contoh katalog sampel: /Environments Jalur folder dapat dimulai dengan atau tanpa garis miring (/).
   Pengidentifikasi rahasia	Masukkan pengidentifikasi rahasia yang berisi PAT Anda untuk repositori. Saat Anda menyalin pengidentifikasi rahasia, string koneksi menyertakan pengidentifikasi versi di akhir, seperti dalam contoh ini: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. Menghapus pengidentifikasi versi memastikan bahwa Lingkungan Penyebaran mengambil versi terbaru rahasia dari brankas kunci. Jika PAT Anda kedaluwarsa, hanya brankas kunci yang perlu diperbarui. Contoh pengidentifikasi rahasia: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. Di Katalog, verifikasi bahwa katalog Anda muncul. Ketika koneksi berhasil, Status membaca Sinkronisasi berhasil.

Menampilkan item katalog yang disinkronkan

Terlepas dari jenis repositori yang Anda gunakan, Anda dapat melihat item katalog yang disinkronkan dari katalog.

1. Di menu sebelah kiri untuk pusat dev atau proyek Anda, di bawah Konfigurasi lingkungan, pilih Katalog.

2. Di panel Katalog , pilih nama katalog.

   

3. Anda melihat daftar item katalog yang berhasil disinkronkan.

   

Memperbarui katalog

Jika Anda memperbarui definisi atau konten templat di repositori terlampir, Anda dapat memberikan serangkaian definisi lingkungan terbaru ke tim pengembangan Anda dengan menyinkronkan katalog. Anda dapat menyinkronkan katalog secara manual atau otomatis.

Menyinkronkan katalog secara manual

Saat Anda menyinkronkan katalog secara manual, Lingkungan Penyebaran memindai melalui repositori dan membuat daftar definisi lingkungan terbaru tersedia untuk semua proyek terkait di pusat pengembangan.

1. Di menu sebelah kiri untuk pusat pengembangan Anda, di bawah Konfigurasi lingkungan, pilih Katalog.

2. Pilih katalog tertentu, lalu dari bilah perintah, pilih Sinkronkan.

   

Menyinkronkan katalog secara otomatis

Saat Anda mengonfigurasi katalog untuk disinkronkan secara otomatis, Lingkungan Penyebaran memindai melalui repositori setiap 30 menit dan membuat daftar definisi lingkungan terbaru tersedia untuk semua proyek terkait di pusat pengembangan.

1. Di menu sebelah kiri untuk pusat dev atau proyek Anda, di bawah Konfigurasi lingkungan, pilih Katalog.

2. Pilih katalog tertentu, lalu pilih edit.

   

3. Di panel Edit katalog , pilih Sinkronkan katalog ini secara otomatis, lalu pilih Simpan.

   

Menghapus katalog

Anda dapat menghapus katalog untuk menghapusnya dari pusat pengembangan atau proyek Azure Deployment Environments. Templat dalam katalog yang dihapus tidak tersedia untuk tim pengembangan saat mereka menyebarkan lingkungan baru. Perbarui referensi definisi lingkungan untuk lingkungan yang ada yang dibuat dengan menggunakan definisi lingkungan dalam katalog yang dihapus. Jika referensi tidak diperbarui dan lingkungan disebarkan ulang, penyebaran gagal.

Untuk menghapus katalog:

1. Di menu sebelah kiri untuk pusat dev atau proyek Anda, di bawah Konfigurasi lingkungan, pilih Katalog.

2. Pilih katalog tertentu, lalu pilih Hapus.

3. Dalam dialog Hapus katalog, pilih Lanjutkan untuk menghapus katalog.

Memecahkan masalah kesalahan sinkronisasi katalog

Saat menambahkan atau menyinkronkan katalog, Anda mungkin mengalami kesalahan sinkronisasi atau peringatan. Kesalahan sinkronisasi menunjukkan bahwa katalog gagal disinkronkan dengan sukses, Peringatan sinkronisasi menunjukkan bahwa beberapa atau semua item katalog memiliki kesalahan. Anda dapat melihat status sinkronisasi dan kesalahan di portal Azure, atau menggunakan Azure CLI dan REST API untuk memecahkan masalah dan mengatasi kesalahan.

Menampilkan status sinkronisasi katalog

Di portal Azure, Anda bisa mendapatkan informasi selengkapnya tentang status sinkronisasi katalog dan peringatan atau kesalahan apa pun dengan memilih tautan status. Tautan status membuka panel yang memperlihatkan status sinkronisasi, jumlah definisi lingkungan yang ditambahkan, dan jumlah definisi lingkungan yang diabaikan atau gagal.

Melihat kegagalan sinkronisasi katalog

1. Di menu sebelah kiri untuk pusat dev atau proyek Anda, di bawah Konfigurasi lingkungan, pilih Katalog.

2. Di kolom Status, pilih tautan status untuk katalog yang gagal disinkronkan.

   

3. Anda melihat panel detail yang memperlihatkan perubahan dalam sinkronisasi terakhir, jumlah kesalahan sinkronisasi, dan jenis kesalahan.

   

Melihat peringatan sinkronisasi katalog

1. Di menu sebelah kiri untuk pusat dev atau proyek Anda, di bawah Konfigurasi lingkungan, pilih Katalog.

2. Di kolom Status, pilih tautan status untuk katalog yang disinkronkan tetapi melaporkan peringatan.

   

3. Anda melihat panel detail yang memperlihatkan perubahan dalam sinkronisasi terakhir, jumlah kesalahan item, serta jenis dan sumber setiap kesalahan.

   

4. Anda dapat melihat item yang berhasil disinkronkan dari katalog yang juga melaporkan kesalahan sinkronisasi. Dari panel Katalog , pilih nama katalog.

   

5. Anda melihat daftar item katalog yang berhasil disinkronkan.

   

Memecahkan masalah kesalahan sinkronisasi katalog dengan menggunakan Azure CLI

Gunakan Azure CLI atau REST API untuk MENDAPATKAN katalog. Respons GET menunjukkan jenis kesalahan:

• Definisi lingkungan yang diabaikan yang terdeteksi menjadi duplikat.
• Definisi lingkungan tidak valid yang gagal karena kesalahan skema, referensi, atau validasi.

Mengatasi kesalahan definisi lingkungan yang diabaikan

Kesalahan definisi lingkungan yang diabaikan terjadi jika Anda menambahkan dua definisi lingkungan atau lebih yang memiliki nama yang sama. Anda dapat mengatasi masalah ini dengan mengganti nama definisi lingkungan sehingga setiap definisi lingkungan memiliki nama unik dalam katalog.

Mengatasi kesalahan definisi lingkungan yang tidak valid

Kesalahan definisi lingkungan yang tidak valid mungkin terjadi karena berbagai alasan:

• Kesalahan skema manifes. Pastikan file lingkungan definisi lingkungan Anda cocok dengan skema yang diperlukan.

• Kesalahan validasi. Periksa item berikut untuk mengatasi kesalahan validasi:

  • Pastikan bahwa jenis mesin file lingkungan dikonfigurasi dengan benar.
  • Pastikan bahwa nama definisi lingkungan antara 3 dan 63 karakter.
  • Pastikan bahwa nama definisi lingkungan hanya menyertakan karakter yang valid untuk URL, yang merupakan karakter alfanumerik dan simbol-simbol ini: ~ ! , . ' ; : = - _ + ( ) * & $ @

• Kesalahan referensi. Pastikan bahwa jalur templat yang direferensikan file lingkungan adalah jalur relatif yang valid ke file di repositori.

Konten terkait

• Mengonfigurasi jenis lingkungan untuk pusat pengembangan
• Membuat dan mengonfigurasi proyek dengan menggunakan Azure CLI
• Mengonfigurasi jenis lingkungan proyek