Python paket dizininden (PyPI) paketleri kullanma

  • Makale

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

Geliştiriciler, Azure Artifacts'i kullanarak Azure Artifacts akışlarından ve pypi.org gibi dış kayıt defterlerinden paketler yayımlayabilir ve kullanabilir. 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.

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.

    A screenshot showing how to create a need feed.

PyPI yukarı akışı 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 gear icon seçerek Akış Ayarlar 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 Kaydet'i seçin ve sonra değişikliklerinizi kaydetmek için sağ üst köşeden Bir kez daha kaydet'i seçin.

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 ardından 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.

    A screenshot showing packages installed from PyPI upstream.