Python paket dizininden (PyPI) paketleri kullanma

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts, geliştiricilerin kendi paketlerini ve PyPI.org gibi genel kayıt defterlerinden yüklenen paketleri barındırmak için tek bir akış kullanmasına olanak tanır. Yukarı akış kaynakları etkinleştirildiğinde Azure Artifacts, bir yukarı akış kaynağından yüklenen tüm paketlerin bir kopyasını bir ortak çalışan veya üzeri tarafından otomatik olarak kaydeder. Bu makalede projenizi ayarlama ve komut satırını kullanarak Python Paket Dizini'nden (PyPI) Python paketlerini kullanma adımları gösterilir.

Önkoşullar

ürün Gereksinimler
Azure DevOps - Azure DevOps kuruluşu.
- Azure DevOps projesi.
- Python indirip yükleyin.

Yeni bir akış oluştur ve genel üst akışları ekle

Henüz bir akışınız yoksa, aşağıdaki adımları izleyerek bir akış oluşturun ve Yukarı akış kaynaklarını etkinleştirin. Aksi takdirde, PyPI'yi yukarı akış kaynağı olarak eklemek için sonraki adıma geçin.

  1. Azure DevOps'ta oturum açın ve projenize gidin.

  2. Yapıtlar'ı ve ardından Akış Oluştur'u seçin.

  3. Akışınız için açıklayıcı bir Ad girin ve Görünürlük ayarını yapın. Kapsamı belirtin ve genel kayıt defterlerindeki paketleri eklemek için Yukarı akış kaynakları onay kutusunu işaretleyin.

  4. İşiniz bittiğinde Oluştur'u seçin.

    Azure Artifacts'te ihtiyaç akışı oluşturmayı ve yukarı akış kaynaklarını etkinleştirmeyi gösteren ekran görüntüsü.

PyPI yukarı akışı ekleme

Akışınızı oluştururken Yukarı Akış Kaynakları'nı etkinleştirdiyseniz PyPI otomatik olarak yukarı akış kaynağı olarak eklenmelidir. Aksi takdirde, şu adımları izleyerek el ile ekleyebilirsiniz:

  1. Azure DevOps'ta oturum açın ve projenize gidin.

  2. Yapıtlar'ı ve ardından dişli simgesini dişli simgesi seçerek Akış Ayarları'nı açın.

  3. Yukarı Akış Kaynakları'nın ardından Yukarı Akış Ekle'yi seçin.

  4. Genel kaynak'ı ve ardından açılan listeden PyPI (https://pypi.org/) öğesini seçin.

  5. Değişikliklerinizi uygulamak için Ekle'yi ve ardından sağ üst köşedeki Kaydet'i seçin.

Akışınızla kimlik doğrulaması

Python'ı önkoşullardan yüklediğinizden emin olun ve beslemenize bağlanmak için şu adımları izleyin:

  1. Python paket yöneticinizi yükseltmek için aşağıdaki komutu çalıştırın:

    python -m pip install --upgrade pip
    
  2. Azure Artifacts anahtarlığını yüklemek için aşağıdaki komutu çalıştırın:

    pip install keyring artifacts-keyring
    
  3. Azure DevOps ile kimlik doğrulaması yapmak için Kişisel erişim belirteci oluşturun ve Paketleme ile > kapsamlarını seçin. Azure DevOps'a ilk kez bağlandığınızda kimlik bilgileri istenir. Kullanıcı adı için herhangi bir değer girin ve parola olarak PAT'nizi kullanın. Bu kimlik bilgileri yerel olarak önbelleğe alınır ve bir sonraki kimlik doğrulamasınızda yeniden kullanılır.

  4. Proje dizininize gidin ve bir sanal ortam oluşturun:

    python -m venv <VIRTUAL_ENVIRONMENT_NAME>
    
  5. Sanal ortamınızda bir pip.ini dosyası (Windows) veya pip.conf dosyası (macOS/Linux) oluşturun ve aşağıdaki kod parçacığını ekleyin. Yer tutucuları uygun değerlerle değiştirin. Kişisel erişim belirtecinizi içerdiğinden bu dosyayı genel bir depoya kaydetmeyin.

    • Proje kapsamlı akış:

      [global]
      extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/pypi/simple/
      
    • Kuruluş kapsamlı akış:

      [global]
      extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/pypi/simple/
      

PyPI'dan paketleri yükleme

Şimdi beslemenizde kimlik doğrulaması yaptığınıza göre, pip ile normalde yaptığınız gibi PyPI yukarı akışından paketler yükleyebilirsiniz. Yüklediğiniz tüm paketler otomatik olarak Azure Artifacts akışınıza kaydedilir.

Bu örnekte, Python için popüler bir HTTP kitaplığı olan istekleri yükleyeceksiniz.

Uyarı

Yukarı akış kaynaklarından paketleri kaydetmek için Akış ve Yukarı Akış Okuyucusu (Ortak Çalışan) rolüne veya daha yüksek bir role sahip olmanız gerekir. Daha fazla ayrıntı için bkz. izinleri yönetme .

  1. Bir komut istemi açın ve proje dizininize gidin, ardından sanal ortamınızı etkinleştirin. Yer tutucuyu daha önce oluşturduğunuz sanal ortamın adıyla değiştirin:

    <YOUR_VIRTUAL_ENVIRONMENT_NAME>/Scripts/Activate
    
  2. PyPI'dan istek paketini yüklemek için aşağıdaki komutu çalıştırın.

    pip install requests
    
  3. Yükleme tamamlandıktan sonra Azure Artifacts paketin bir kopyasını akışınıza kaydeder. Aşağıdaki ekran görüntüsünde gösterildiği gibi paketin kullanılabilir olduğunu doğrulamak için akışınıza gidin.

    PyPI yukarı akışından yüklenen istek paketini gösteren ekran görüntüsü.