Öğretici: Yukarı akış kaynaklarını kullanma

Makale
09/27/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Akışınızda yukarı akış kaynaklarını kullanmak, uygulama bağımlılıklarınızı tek bir akıştan yönetmenizi sağlar. Yukarı akış kaynaklarının kullanılması, kesintilere veya güvenliği aşılmış paketlere karşı koruma sağlarken genel kayıt defterlerindeki paketlerin kullanılmasını kolaylaştırır. Ayrıca kendi paketlerinizi aynı akışta yayımlayabilir ve tüm bağımlılıklarınızı tek bir konumda yönetebilirsiniz.

Bu öğreticide, akışınızda yukarı akış kaynaklarını etkinleştirme ve NuGet.org veya npmjs.com gibi genel kayıt defterlerindeki paketleri kullanma konusunda size yol gösterilir.

Bu öğreticide şunları yapacaksınız:

Yeni bir akış oluşturun ve yukarı akış kaynaklarını etkinleştirin.
Yapılandırma dosyanızı ayarlayın.
Akışınızı doldurmak için ilk paket geri yüklemesini çalıştırın.
Genel kayıt defterinden kullandığınız paketlerin kaydedilmiş kopyasını görüntülemek için akışınızı denetleyin.

Akış oluşturma ve yukarı akış kaynaklarını etkinleştirme

Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.
Yapıtlar'ı seçin ve ardından Yeni bir akış oluşturmak için Akış Oluştur'u seçin.
Akışınız için bir ad girin ve görünürlüğünü seçin. Genel kaynaklardan paketleri dahil et onay kutusunu işaretleyip yukarı akış kaynaklarını etkinleştirdiğinizden emin olun ve işiniz bittiğinde Oluştur'u seçin.

Not

Farklı bir kuruluştan bir akışı yukarı akış kaynağı olarak eklemek için, hedef akış sahibinin, Microsoft Entra kiracımla ilişkili kuruluşlardaki tüm akışlar ve kişiler ile hedef görünümü paylaşması gerekir. Akış Ayarları>Görünümleri> Belirtilen görünümün >sağ tarafındaki üç nokta düğmesini seçin Düzenle seçeneğine gidin.

Yapılandırma dosyasını ayarlama

Akışımızı oluşturduğumuza göre, yapılandırma dosyasını akışımıza işaret eden şekilde güncelleştirmemiz gerekir. Bunu yapmak için:

Kaynağın URL'sini alma
Yapılandırma dosyasını güncelleştirme

Yapıtlar'ı ve ardından Akışa bağlan'ı seçin.
Sayfanın sol tarafında npm sekmesini seçin.
Yapılandırma dosyanızı ayarlamak için Proje kurulumu bölümündeki yönergeleri izleyin.

Henüz bir .npmrc dosyanız yoksa, projenizin kökünde (package.json ile aynı klasörde) yeni bir dosya oluşturun. Yeni .npmrc dosyanızı açın ve önceki adımda kopyaladığınız kod parçacığını yapıştırın.

Yapıtlar'ı seçin ve ardından açılan listeden akışınızı seçin.
Akışa bağlan'ı ve ardından Python bölümünün altında pip'i seçin.
Henüz yapmadıysanız bir sanal ortam oluşturun.
virtualenv'inize bir pip.ini (Windows) veya pip.conf (Mac/Linux) dosyası ekleyin ve aşağıdaki kod parçacığını yapıştırın:
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

Yapıtlar'ı seçin ve ardından açılan listeden akışınızı seçin.
Akışa bağlan'ı ve ardından Maven'ı seçin.

pom.xml ve <distributionManagement> bölümlerine <repositories> aşağıdaki kod parçacığını ekleyin:

<repository>
  <id>[FEED-NAME]</id>
  <url>https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

settings.xml dosyanıza bir <server> ekleyin:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Paketleme>Okuma ve yazma kapsamları ile kişisel erişim belirteci oluşturun ve kişisel erişim belirtecinizi settings.xml dosyanızdaki etikete <password> yapıştırın.

Yapıtlar'ı seçin ve ardından açılan listeden akışınızı seçin.
Akışa bağlan'ı ve ardından Gradle'ı seçin.

Build.gradle dosyanızdaki depolara ve yayımlama bölümlerine aşağıdaki kod parçacığını ekleyin:

maven {
    url 'https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1'
    name '[FEED-NAME]'
    authentication {
        basic(BasicAuthentication)
    }
}

settings.xml dosyanıza bir <server> ekleyin:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Paketleme>Okuma ve yazma kapsamları ile kişisel erişim belirteci oluşturun. Kişisel erişim belirtecinizi settings.xml dosyanızdaki etikete <password> yapıştırın.

Paketleri geri yükleme

Artık yukarı akış kaynaklarını etkinleştirdiğinize ve yapılandırma dosyanızı ayarladığınıza göre, yukarı akış kaynağını sorgulamak ve yukarı akış paketlerini almak için paket geri yükleme komutunu çalıştırabiliriz.

projenizden node_modules klasörünü kaldırın ve yükseltilmiş bir komut istemi penceresinde aşağıdaki komutu çalıştırın:

npm install --force