Python paket dizininden (PyPI) paketleri kullanma

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

Geliştiriciler, Azure Artifacts'i kullanarak hem Azure Artifacts akışlarından hem de PyPI.org gibi dış kayıt defterlerinden paketler yayımlayabilir ve kullanabilir. Yukarı akış kaynaklarını etkinleştirerek, hem kendi paketlerinizi hem de genel kayıt defterlerinden tüketilenleri yönetmek için tek bir akış kullanarak paket yönetiminizi kolaylaştırabilirsiniz. Etkinleştirildikten sonra Azure Artifacts, bir ortak çalışan veya üzeri tarafından yüklenen tüm paketlerin bir kopyasını yukarı akış kaynağından otomatik olarak kaydeder. Bu makale, projenizi ayarlama ve Komut satırını kullanarak PyPI'den Python paketlerini verimli bir şekilde kullanma konusunda size yol gösterir.

Bu makalede şunları yapmayı öğreneceksiniz:

  • Akışınız için yukarı akış kaynaklarını etkinleştirme
  • PyPI'yi yukarı akış kaynağı olarak ekleme
  • Projenizi ayarlama
  • Python paket dizininden paketleri yükleme

Önkoşullar

  • Bir Azure DevOps kuruluşu ve bir proje. Henüz yapmadıysanız bir kuruluş veya proje oluşturun.

  • Azure Artifacts akışı.

  • Python'ı indirin.

Yeni akış oluştururken yukarı akış kaynaklarını etkinleştirme

Henüz bir akış oluşturmadıysanız, yeni bir akış oluşturmak için aşağıdaki adımları izleyin. Yukarı akış kaynaklarını etkinleştirmek için yukarı akış kaynakları kutusunu işaretlediğinizden emin olun. Zaten bir akışınız varsa, PyPI'yi yukarı akış kaynağı olarak eklemek için sonraki adıma geçin.

  1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

  2. Yapıtlar'ı seçin ve ardından Yeni bir akış oluşturmak için Akış Oluştur'u seçin.

  3. Akışınız için açıklayıcı bir Ad girin ve Görünürlüğünü tanımlayın (akıştaki paketleri kimlerin görüntüleyebileceğini belirtir). Akışınızın Kapsamını 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.

    İhtiyaç akışı oluşturmayı gösteren ekran görüntüsü.

PyPI'yi yeni bir yukarı akış kaynağı olarak ekleme

Akışınızı oluştururken yukarı akış kaynakları onay kutusunu seçtiyseniz PyPI otomatik olarak yukarı akış kaynağı olarak eklenmiş olmalıdır. Aksi takdirde, şu adımları izleyerek el ile ekleyebilirsiniz:

  1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

  2. Yapıtlar'ı seçin ve ardından dişli simgesini dişli simgesi seçerek Akış Ayarları'na gidin.

  3. Yukarı akış kaynakları'na tıklayın ve ardından Yukarı Akış Ekle'yi seçerek yeni bir yukarı akış kaynağı ekleyin.

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

  5. İşiniz bittiğinde Ekle'yi seçin ve ardından sağ üst köşeden Kaydet'i seçerek değişikliklerinizi kaydedin.

    PyPI'nin yeni bir yukarı akış kaynağı olarak nasıl ekleneceğini gösteren ekran görüntüsü.

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

  1. Python'ı indirdiğinizden emin olun ve 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 Paketleme>Okuma kapsamına sahip bir Kişisel erişim belirteci oluşturun. Azure DevOps'a ilk kez bağlandığınızda, istendiğinde kimlik bilgilerinizi girmeniz gerekir. Belirtilen alanlara kullanıcı adınızı (herhangi bir dize) ve kişisel erişim belirtecinizi girin. Bu kimlik bilgileri yerel olarak önbelleğe alınır ve hizmeti bir sonraki kullanışınızda oturum açmak için otomatik olarak kullanılır.

  4. Proje klasörünüze gidin ve yeni bir sanal ortam oluşturmak için aşağıdaki komutu çalıştırın:

    python -m venv <VIRTUAL_ENVIRONMENT_NAME>
    
  5. Sanal ortamınızda yeni bir pip.ini dosyası (Windows) veya pip.conf dosyası (Mac/Linux) oluşturun ve aşağıdaki kod parçacığını dosyanıza yapıştırın. Yer tutucuları uygun bilgilerle değiştirdiğinizden emin olun ve bu dosyayı kişisel erişim belirtecinizi içerdiğinden genel bir depoya işlememeye dikkat edin.

    • 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

Projemizi akışımızla kimlik doğrulaması yapmak üzere yapılandırdığımıza göre, PyPI yukarı akışından paketleri yüklemeye başlayabiliriz. Bu örnekte yükleyeceğiz Flask:

  1. Komut istemi penceresinde proje klasörünüze gidin ve sanal ortamınızı etkinleştirmek için aşağıdaki komutu çalıştırın. Yer tutucuyu daha önce oluşturduğunuz sanal ortamın adıyla değiştirin:

    <YOUR_VIRTUAL_ENVIRONMENT_NAME>/Scripts/Activate.ps1
    
  2. Sanal ortamınızda yüklü paketleri denetlemek için aşağıdaki komutu çalıştırın:

    pip list
    
  3. Flask'i yüklemek için aşağıdaki komutu çalıştırın.

    pip install -U Flask
    
  4. Paketiniz yüklendikten sonra Azure Artifacts bu paketin bir kopyasını akışınıza kaydeder. Paketinizin aşağıdaki ekran görüntüsünde gösterildiği gibi akışınızda kullanılabilir olması gerekir.

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