Azure Artifacts'te npm paketlerini kullanmaya başlama

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

Azure Artifacts'i kullanarak akışlardan ve npmjs.com gibi genel kayıt defterlerinden npm paketlerinizi yayımlayabilir ve indirebilirsiniz. Bu hızlı başlangıç, akışınızı oluşturma, projenizi yapılandırma ve Azure Artifacts akışınızla npm paketlerini yönetme konusunda size yol gösterir.

Önkoşullar

Akış oluşturma

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

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

  3. Ad alanına akışınız için açıklayıcı bir ad girin.

    Görünürlük için, akıştaki paketleri kimlerin görüntüleyebileceğini belirtmek için bir seçenek belirleyin.

    Ortak kaynaklardan gelen paketleri eklemek istiyorsanız Yukarı akış kaynakları altındaki onay kutusunu seçin.

    Kapsam için, akışınızın kapsamının proje mi yoksa kuruluş mu olduğunu belirtin.

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

    Azure DevOps Services'da yeni akış oluşturma seçimlerini gösteren ekran görüntüsü.

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

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

  3. Ad alanına akışınız için açıklayıcı bir ad girin.

    Görünürlük için, akıştaki paketleri kimlerin görüntüleyebileceğini belirtmek için bir seçenek belirleyin.

    Ortak kaynaklardan gelen paketleri eklemek istiyorsanız Yukarı akış kaynakları altındaki onay kutusunu seçin.

    Kapsam için, akışınızın kapsamının proje mi yoksa kuruluş mu olduğunu belirtin.

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

    Azure DevOps 2022'de yeni akış oluşturma seçimlerini gösteren ekran görüntüsü.

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

    Azure DevOps 2020'de yeni akış oluşturma seçimlerini gösteren ekran görüntüsü.

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

  2. Yapıtlar'ı ve ardından Yeni akış'ı seçin.

  3. Ad alanına akışınız için açıklayıcı bir ad girin.

    Görünürlük için, akıştaki paketleri kimlerin görüntüleyebileceğini belirtmek için bir seçenek belirleyin.

    Genel kaynaklardan gelen paketleri dahil etmek istiyorsanız Bu akış aracılığıyla genel kaynaklardan gelen paketleri kullan seçeneğini belirleyin.

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

    Azure DevOps 2019'da yeni akış oluşturmaya yönelik seçimleri gösteren ekran görüntüsü.

Not

Varsayılan olarak, yeni oluşturulan akışlar projelerinin Derleme Hizmeti değerini Akış ve Yukarı Akış Okuyucusu (Ortak Çalışan) olarak ayarlar.

Akışa bağlanma

Not

vsts-npm-auth Azure DevOps Server'da desteklenmez.

Azure Artifacts iki .npmrc dosyası kullanılmasını önerir. İlki $home dizinine (Linux/macOS) veya $env yerleştirilmelidir. HOME (Windows) ile kimlik bilgilerinizi güvenli bir şekilde depolayın. Bu, npm istemcisinin dosyayı bulmasına ve kimlik doğrulaması için kimlik bilgilerinizi almasına olanak tanıyarak, kimlik bilgilerinizi açığa çıkarmadan yapılandırma dosyanızı paylaşmanızı sağlar. Bu bölümde, package.json dosyanızla aynı dizine yerleştirilmesi gereken ikinci .npmrc dosyasını ayarlayacağız.

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

  2. Yapıtlar'ı ve ardından Akışa bağlan'ı seçin.

  3. Sol gezinti alanından npm'yi seçin. Azure Artifacts'i npm ile ilk kez kullanıyorsanız önkoşulları yüklediğinizden emin olun.

  4. Yapılandırma dosyanızı ayarlamak ve akışınıza bağlanmak için Proje kurulumu bölümündeki yönergeleri izleyin.

    Azure DevOps Services'da npm projesi ayarlamayı ve Azure Artifacts akışına bağlanmayı gösteren ekran görüntüsü.

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

  2. Yapıtlar'ı ve ardından Akışa Bağlan'ı seçin.

  3. Soldan npm'yi seçin ve akışınıza bağlanmak için Proje kurulumu bölümündeki yönergeleri izleyin.

    Azure DevOps Server 2022'de npm projesi ayarlamayı ve Azure Artifacts akışına bağlanmayı gösteren ekran görüntüsü.

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

  2. Yapıtlar'ı ve ardından Akışa bağlan'ı seçin.

  3. Soldan npm'yi seçin ve ardından Proje kurulumu'ndaki yönergeleri izleyerek yapılandırma dosyanızı ayarlayın ve akışınıza bağlanın.

    Azure DevOps Server 2020'de npm projesi ayarlamayı ve Azure Artifacts akışına bağlanmayı gösteren ekran görüntüsü.

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

  2. Yapıtlar'ı ve ardından Akışa bağlan'ı seçin.

  3. Yeni bir pencere görüntülenir. Sol gezinti bölmesinde npm'yi seçin ve yönergeleri izleyerek projenizi ve kullanıcı .npmrc dosyalarınızı ayarlayın.

    Azure DevOps Server 2019'da npm projesi ayarlamayı ve Azure Artifacts akışına bağlanmayı gösteren ekran görüntüsü.

Önemli

npm, .npmrc dosyanızda tek registry bir dosyayı destekler. Kapsamlar ve yukarı akış kaynaklarıyla birden çok kayıt defteri mümkündür.

Paketleri yayımlama

Npm paketlerinizi yayımlamak için proje dizininizde aşağıdaki komutu çalıştırın:

npm publish

Önemli

publishConfig Yayımlama zamanında kayıt defteri yapılandırma parametresini geçersiz kılmak için özelliğinin kullanılması desteklenmez.

Paketleri geri yükleme

Npm paketlerinizi geri yüklemek için proje dizininizde aşağıdaki komutu çalıştırın:

npm install

Belirli bir npm paketini geri yüklemek için proje dizininizden aşağıdaki komutu çalıştırın:

npm install --save <PACKAGE_NAME>