Öğretici: Azure DevOps wiki'sini Azure SRE Aracısı'na bağlama

Bu öğreticide, Azure SRE Aracınız için bilgi kaynağı olarak bir Azure DevOps wiki'sini bağlarsınız. Bu adımları tamamladıktan sonra, aracı, araştırmalar sırasında soruları yanıtladığında ekibinizin wiki'sinde çalışma kitaplarını ve yordamları arayabilir.

Bu eğitimde şunları öğreniyorsunuz:

  • Belge bağlayıcısını kullanarak Azure DevOps wiki'sini bağlama
  • Yönetilen kimlik ve kişisel erişim belirteci (PAT) kimlik doğrulaması arasında seçim yapma
  • Aracınıza wiki içeriğini kullanan bir soru sorarak bağlantıyı doğrulayın

Tahmini süre: 10 dakika

Önkoşullar

Başlamadan önce aşağıdaki kaynaklara ve erişime sahip olduğunuzdan emin olun:

  • Azure SRE Aracısı (zaten oluşturulmuş).
  • İçerik içeren wiki içeren bir Azure DevOps projesi.
  • Şu kimlik doğrulama seçeneklerinden biri:
    • Yönetilen kimlik: Azure DevOps kuruluşunuzda aracınızın yönetilen kimliğini kullanıcı olarak ekleyin (Kuruluş Ayarları>Kullanıcılar>Kullanıcı ekle>, kimliğin istemci kimliğini girin).
    • Kişisel erişim belirteci (PAT): Kod (Okuma) kapsamıyla Azure DevOps'ta oluşturun.

Wiki URL'nizi alma

Wiki'nizi bağlamak için öncelikle Azure DevOps'un URL'sine ihtiyacınız vardır.

  1. Azure DevOps projenize gidin.
  2. Sol kenar çubuğunda Wiki'yi seçin.
  3. Tarayıcınızın adres çubuğundan URL'yi kopyalayın.

URL'niz şu örneğe benzer:

https://dev.azure.com/{your-org}/{your-project}/_wiki/wikis/{wiki-name}

Eski URL'ler de desteklenir:

https://{your-org}.visualstudio.com/{your-project}/_wiki/wikis/{wiki-name}

Tip

Wiki'nizin yalnızca belirli bir bölümünü dizine almak için önce Azure DevOps'ta bu bölüme gidin, ardından URL'yi kopyalayın. URL'deki sayfa kimliği, aracınıza yalnızca bu sayfada ve alt sayfalarında gezinmesini söyler. Bu yaklaşım, yalnızca /Operations veya /Runbooks gibi bir bölümün ilgili olduğu büyük vikiler için kullanışlıdır.

Bağlayıcılar sayfasını açma

Azure SRE Aracısı portalında bağlayıcı yapılandırmasına gidin.

  1. sre.azure.com'a gidin.
  2. Temsilcinizi seçin.
  3. Sol kenar çubuğunda Oluşturucu'yu açın.
  4. Bağlayıcılar'ı seçin.

Adlarını, hizmet türlerini ve bağlantı durumunu gösteren mevcut bağlayıcılarınızın listesi görüntülenir.

Bağlayıcı ekleme sihirbazını başlatma

Üç adımlı bir sihirbazı açmak için araç çubuğunda Bağlayıcı ekle'yi seçin:

  1. Bağlayıcı seçin: Bağlayıcı türünü seçin.
  2. Bağlayıcıyı ayarlama: Adı, URL'yi ve kimlik doğrulamayı yapılandırın.
  3. Gözden geçir + ekle: Onaylayın ve oluşturun.

Belge bağlayıcısını seçin

Bağlayıcı seçicide Azure DevOps alt başlığıyla Belgeler bağlayıcısı'nı bulun ve seçin. Bağlayıcı açıklaması şu şekildedir: "Aracı, projelerinizi ve süreçlerinizi anlamak için belgelere ve dosyalara başvurur."

Kurulum formuna devam etmek için İleri'yi seçin.

Bağlayıcıyı yapılandırma

Form başlığıNda Azure DevOps bağlayıcısını ayarlama gösterilir. Aşağıdaki alanları doldurun:

Alan Ne girmeliyim?
İsim Açıklayıcı bir ad (örneğin, ops-wiki veya team-runbooks)
Azure DevOps URL'si Önceki adımdaki wiki URL'niz

Kimlik doğrulama yönteminizi seçin

Aşağıdaki kimlik doğrulama seçeneklerinden birini seçin.

  1. Yönetilen Kimlik'i seçin (varsayılan olarak seçilidir).
  2. Yönetilen kimlik açılır listesinden yönetilen kimliğinizi seçin (varsayılan olarak Sistem atanmış).
  3. İsteğe bağlı olarak, Yönetilen kimliği federasyon kimlik bilgisi olarak kullan seçeneğini seçin.

Seçenek B: Kişisel erişim belirteci (PAT)

  1. Kişisel Erişim Belirteci (PAT) öğesini seçin.
  2. Azure DevOps PAT'nizi Kişisel Erişim Belirteci alanına yapıştırın.

gözden geçirme adımına devam etmek için İleri'yi seçin.

Bağlayıcıyı gözden geçirme ve oluşturma

Özet ekranında bağlayıcınızın ayrıntılarını gözden geçirin ve ardından gönder düğmesini seçerek bağlayıcıyı oluşturun.

Yeni bağlayıcınız bağlayıcılar listesinde Bağlandı (yeşil onay işareti) durumuyla görüntülenir.

Uyarı

Wiki'nizin boyutuna bağlı olarak ilk dizin oluşturma birkaç dakika sürebilir. Dizin oluşturma tamamlandıktan sonra aracınız wiki içeriğini kullanabilir.

Bağlantıyı doğrulama

Aracıya wiki içeriğinizin yanıt verebileceği bir soru sorarak yeni wiki bağlantısını test edin.

  1. Kenar çubuğunda Yeni sohbet yazışması'nı seçin.
  2. Wiki içeriğinizin yanıtlayabileceğiniz bir soru sorun.

Örneğin:

What are our standard procedures for handling a database failover?

Aracınız wiki'nizi diğer bilgi kaynaklarıyla birlikte arar ve yanıtında özgün wiki sayfasına bağlanan alıntılar içerir. Yanıt, Azure DevOps'taki kaynak wiki sayfasına bir alıntı bağlantısı içerir.

Sorun giderme

Azure DevOps wiki bağlayıcısıyla ilgili yaygın sorunları çözmek için aşağıdaki tabloyu kullanın.

Sorun Çözüm
Bağlayıcı Bağlantı Kesik gösteriyor Wiki URL biçiminizi ve kimlik doğrulama kimlik bilgilerinizi doğrulayın.
Wiki içeriği yanıtlarda görünmüyor İlk dizin oluşturma işleminin tamamlanması için birkaç dakika bekleyin ve yeniden deneyin.
URL doğrulama hatası URL'nin https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} veya https://dev.azure.com/{org}/{project}/_git/{repo} ile eşleştiğinden emin olun. Eski visualstudio.com URL'ler de kabul edilir.
PAT kimlik doğrulaması başarısız oluyor PAT'nizin Kod (Okuma) kapsamına sahip olup olmadığını ve süresinin dolmadığını denetleyin.
Yönetilen kimlik başarısız oluyor Aracının yönetilen kimliğinin Azure DevOps kuruluşunuzda kullanıcı olarak eklendiğini doğrulayın (Kuruluş Ayarları>Kullanıcılar).

Sonraki adım

ADO Wiki bilgisi hakkında bilgi edinin

İlgili içerik

  • Last updated on