Создание и публикация пакета Node.js

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

В этом кратком руководстве вы используете конвейер для создания пакета Node.js с помощью node диспетчер пакетов (npm) и публикации артефакта конвейера. Вы узнаете, как использовать Azure Pipelines для создания, развертывания и тестирования приложений JavaScript.

Предварительные условия

• Учетная запись GitHub, в которой можно создать репозиторий. Создайте бесплатную учетную запись GitHub.
• Организация Azure DevOps. Создайте ее бесплатно.
• Проект Azure DevOps. Создайте его с помощью мастера создания проекта Azure DevOps.
• Возможность запуска конвейеров на размещенных корпорацией Майкрософт агентах. Вам нужно запросить бесплатное предоставление параллельных заданий или приобрести параллельное задание.

Сделайте форк примера кода

Создайте форк примерного серверного приложения на Express.js.

1. Перейдите в репозиторий js-e2e-express-server .
2. Выберите Fork в правом верхнем углу страницы.
3. Выберите учетную запись GitHub. По умолчанию форк называется так же, как родительский репозиторий, но вы можете дать ему другое название.

Внимание

В следующих процедурах вам может быть предложено создать соединение службы GitHub или вы будете перенаправлены на GitHub для входа в систему, установки Azure Pipelines или авторизации Azure Pipelines. Следуйте инструкциям на экране, чтобы завершить процесс. Дополнительные сведения см. в разделе Доступ к репозиториям GitHub.

Создание конвейера

YAML

1. В проекте Azure DevOps выберите Pipelines Create Pipelines>, а затем выберите GitHub в качестве расположения исходного кода.
2. На экране "Выбор репозитория" выберите форк вашего образца репозитория.
3. На экране "Настройка конвейера" выберите "Начальный конвейер". Azure Pipelines создает файл YAML с именем azure-pipelines.yml для конвейера.
4. Выберите раскрывающийся список рядом с пунктом "Сохранить и запустить", нажмите кнопку "Сохранить" и снова нажмите кнопку "Сохранить ". Файл сохранён в ваш форкнутый репозиторий GitHub.
5. На следующем экране нажмите кнопку "Изменить".

Создание пакета и публикация артефакта

Измените файл azure-pipelines.yml следующим образом.

1. Замените содержимое файла на код, приведенный ниже. Код обновляет задачу установщика средств Node.js, чтобы использовать Node.js версии 16 LTS.

   trigger:
   - main
   
   pool:
     vmImage: 'ubuntu-latest'
   
   steps:
   - task: UseNode@1
     inputs:
       version: '16.x'
     displayName: 'Install Node.js'
   
   - script: |
       npm install
     displayName: 'npm install'
   
   - script: |
       npm run build
     displayName: 'npm build'
   
   - script: 
       npm test
     displayname: 'npm test'
   
   

2. Добавьте следующие новые задачи в конвейер:

   • Задача копирования файлов копирует файлы из папок src и public в промежуточный каталог артефактов сборки.

   • Задача публикации артефакта конвейера получает файлы из промежуточного расположения артефактов и публикует их как артефакты для окончания сборок конвейера.

   - task: CopyFiles@2
     inputs:
       sourceFolder: '$(Build.SourcesDirectory)'
       contents: |
          src/*
          public/*
       targetFolder: '$(Build.ArtifactStagingDirectory)'
     displayName: 'Copy project files'
   
   - task: PublishPipelineArtifact@1
     inputs:
       artifactName: e2e-server
       targetPath: '$(Build.ArtifactStagingDirectory)'
       publishLocation: 'pipeline'
     displayName: 'Publish npm artifact'
   

Запустите ваш конвейер

Выберите " Проверить и сохранить", а затем нажмите кнопку "Сохранить", " Запустить" и " Выполнить снова".

После выполнения конвейера убедитесь, что задача была успешно завершена, и убедитесь, что виден опубликованный артефакт.

Классическое

1. Выберите GitHub в качестве источника кода.

2. В разделе «Репозиторий» выберите ваш форкнутый репозиторий и нажмите «Продолжить».

3. Выберите "Пустой конвейер" и нажмите кнопку "Применить".

4. В разделе "Спецификация агента" в правой области выберите ubuntu-latest.

5. В левой области добавьте следующие задачи в конвейер в указанном порядке. Для каждой +задачи выберите задание агента 1, выберите задачу справа и нажмите кнопку "Добавить" и при необходимости настройте задачу.

   1. npm

   2. npm

      • Отображаемое имя:npm test
      • Команда:настраиваемая
      • Команда и аргументы:тест

   3. Публикация результатов теста

   4. Архивные файлы

      • Корневая папка или файл для архивации:$(System.DefaultWorkingDirectory)
      • Добавить имя корневой папки в начало путей архива: снимите флажок

   5. Публикация артефактов сборки

6. Выберите «Сохранить и поставить в очередь», а затем нажмите «Сохранить и запустить».

   

Поздравляем, вы успешно создали и запустили конвейер, который создал и проверил пакет Node.js. Вы можете создавать, тестировать и развертывать приложения Node.js в рамках системы непрерывной интеграции Azure Pipelines и непрерывной доставки (CI/CD).

Следующие шаги

Настройка JavaScript