Файл Yml, как создать из xls

Обновлено: 03.07.2024

Следующий подключаемый модуль предоставляет функциональные возможности, доступные с помощью шагов, совместимых с Pipeline. Подробнее о том, как интегрировать шаги в конвейер, см. в разделе «Шаги» на странице «Синтаксис конвейера».

Список других подобных подключаемых модулей см. на странице справки по этапам конвейера.

Утилиты пайплайна

compareVersions: сравнение двух строк номеров версий

Сравните два номера версии друг с другом. См. VersionNumber.java, чтобы узнать, как обрабатываются строки версий.

Возвращаемое значение — целое число;

  • -1, если v1
  • 0, если v1 == v2
  • 1, если v1 > v2

Строка номера версии, которая будет сравниваться с v2 .

Строка номера версии, с которой будет сравниваться v1.

Сбой сборки, если v1 или v2 пусты или пусты.

По умолчанию пустая строка или значение NULL рассматриваются как самая ранняя версия, и ее сборка не приведет к сбою. То есть:

  • null по сравнению с null == 0
  • пусто по сравнению с пустым == 0
  • null по сравнению с пустым == 0
  • нулевой или пустой по сравнению с чем-либо == -1
  • все по сравнению с нулевым или пустым == 1

findFiles: поиск файлов в рабочей области

Найти файлы в текущем рабочем каталоге. Шаг возвращает массив объектов информации о файле, свойства которых вы можете увидеть в приведенном ниже примере.
Пример: def files = findFiles(glob: '**/TEST-*.xml') echo """$ $ $ $ $"""

Шаблоны путей к файлам в стиле Ant, которые должны совпадать. Если это свойство установлено, все потомки текущего рабочего каталога будут найдены для совпадения и возвращены, если оно опущено, будут возвращены только прямые потомки каталога.

nodesByLabel: список узлов по метке, по умолчанию исключая офлайн-узлы.

  • ярлык
    • Тип: строка
    • Тип: логический

    prependToFile : создать файл (если он еще не существует) в рабочей области и добавить заданное содержимое в начало этого файла.

    Создает файл, если он еще не существует, и добавляет к нему заданное содержимое.

    Путь к файлу, который будет добавлен в начале.

    Содержимое для добавления в начале.

    readCSV: чтение содержимого из CSV-файла в рабочей области.

    Читает файл в текущем рабочем каталоге или строку как обычный текст. Возвращается список экземпляров CSVRecord

    Пример:

    Расширенный пример:

    Путь к файлу в рабочей области, из которого считываются данные CSV. Доступ к данным осуществляется как к списку массивов строк.

    Вы можете указать только файл или текст , но не оба в одном вызове.

    Строка, содержащая данные в формате CSV. Доступ к данным осуществляется как к списку массивов строк.

    Вы можете указать только файл или текст , но не оба в одном вызове.

    readJSON: чтение JSON из файлов в рабочей области.

    Читает файл в текущем рабочем каталоге или строку как обычный текстовый файл JSON. Возвращаемый объект является обычной картой со строковыми ключами, списком примитивов или картой.

    Пример:

    Путь к файлу в рабочей области, из которого считываются данные JSON. К данным можно обращаться как к массиву или карте.

    Вы можете указать только файл или текст , но не оба в одном вызове.

    Преобразует выходные данные в тип POJO ( LinkedHashMap или ArrayList ) перед возвратом.

    По умолчанию деактивировано ( false ), и возвращается объект JSON ( JSONObject или JSONArray из json-lib).

    Строка, содержащая данные в формате JSON. К данным можно обращаться как к массиву или карте.

    Вы можете указать только файл или текст , но не оба в одном вызове.

    readManifest: чтение манифеста Jar

    Читает файл или текст манифеста Jar и анализирует его в набор карт. Возвращаемая структура данных имеет два свойства: main для основных атрибутов и записи, содержащие каждый отдельный раздел (кроме main).

    Пример:

    Необязательный путь к файлу для чтения. Это может быть обычный текст, .jar, .war или .ear. В последнем случае манифест будет извлечен из архива, а затем прочитан.

    Вы можете указать только файл или текст , но не оба в одном вызове.

    Необязательный текст, содержащий данные манифеста.

    Вы можете указать только файл или текст , но не оба в одном вызове.

    readMavenPom: чтение файла проекта maven.

    Читает файл проекта Maven. Возвращаемый объект является моделью .

    Не используйте этот шаг и напишите MavenPom . Лучше использовать шаг sh для запуска целей mvn. Например:

    Необязательный путь к файлу для чтения. Если оставить пустым, шаг попытается прочитать pom.xml в текущем рабочем каталоге.

    readProperties: чтение свойств из файлов в рабочей области или тексте.

    Читает файл в текущем рабочем каталоге или строку как простой текстовый файл свойств Java. Возвращаемый объект представляет собой обычную карту со строковыми ключами.Карта также может быть предварительно загружена со значениями по умолчанию перед чтением/анализом данных.

    • file : необязательный путь к файлу в рабочей области, из которого будут считываться свойства. Они добавляются к результирующей карте после значений по умолчанию, поэтому любые уже существующие пары "ключ-значение" будут перезаписаны.
    • текст : необязательная строка, содержащая данные в формате свойств. Они добавляются к результирующей карте после файла, поэтому любые уже существующие пары "ключ-значение" будут перезаписаны.
    • defaults : необязательная карта, содержащая ключи и значения по умолчанию. Они сначала добавляются к результирующей карте.
    • interpolate : флаг, указывающий, следует ли интерполировать свойства. В случае ошибки или зацикливания зависимостей будут возвращены исходные свойства.

    Пример:

    Пример с интерполяцией:

    • значения по умолчанию (необязательно)
      • Тип: java.util.Map
      • Тип: строка
      • Тип: логический
      • Тип: строка

      readYaml: чтение yaml из файлов в рабочей области или тексте.

      Читает файл в текущем рабочем каталоге или строку как обычный текстовый файл YAML. Он использует SnakeYAML в качестве процессора YAML. Возвращаемые объекты являются стандартными объектами Java, такими как List, Long, String, . bool: [true, false, on, off] int: 42 float: 3.14159 list: ['LITE', 'RES_ACID', 'SUS_DEXT'] map:

      • file : необязательный путь к файлу в рабочей области для чтения данных YAML.
      • текст: необязательная строка, содержащая данные в формате YAML. Они добавляются к результирующему объекту после файла и поэтому перезаписывают любое уже существующее значение, если это не новый документ YAML

      Примеры:
      только с одним документом YAML:

      С несколькими документами YAML: с файлом dir/my.yml, содержащим что-то: «мои данные»:

      • файл (необязательно)
        • Тип: строка
        • Тип: строка

        sha1 : Вычислить SHA1 данного файла

        Вычисляет SHA1 заданного файла.

        Путь к файлу для хеширования.

        sha256 : Вычислить SHA256 заданного файла

        Вычисляет SHA256 заданного файла.

        Путь к файлу для хеширования.

        tar : создать файл Tar

        Создайте файл содержимого tar/tar.gz в рабочей области.

        Имя/путь создаваемого tar-файла.

        Если файл tar должен быть заархивирован как артефакт текущей сборки. Файл останется в рабочей области после архивации.

        Созданный файл tar должен быть сжат как gz.

        Путь к базовому каталогу, из которого создается tar. Оставьте пустым, чтобы создать из текущего рабочего каталога.

        Шаблон файлов в стиле Ant для исключения из tar.

        Шаблон файлов в стиле Ant для включения в tar. Оставьте пустым, чтобы включить все файлы и каталоги.

        Должен ли файл tar быть перезаписан в случае, если уже существует файл с таким же именем.

        tee : вывод тройника в файл

        touch : создать файл (если он еще не существует) в рабочей области и установить отметку времени

        Создает файл, если он еще не существует, и обновляет метку времени.

        Путь к файлу для касания.

        Отметка времени для установки (количество мс с момента epoc), оставьте пустым для текущего системного времени.

        untar: извлечь файл Tar

        Извлеките файл tar/tar.gz в рабочую область.

        Имя/путь файла tar/tar.gz для извлечения.

        Путь к базовому каталогу, в который следует распаковать tar. Оставьте пустым для извлечения в текущий рабочий каталог.

        Шаблон файлов в стиле Ant для извлечения из tar. Оставьте пустым, чтобы включить все файлы и каталоги.

        Подавить подробный вывод, который регистрирует каждый файл, с которым работают. Например, распаковать файл: 'example.tgz', тишина: true

        Проверьте целостность архива, а не извлекайте его. Если этот параметр включен, все остальные параметры (кроме файла) будут игнорироваться. Шаг вернет значение true или false в зависимости от результата, а не вызовет исключение.

        unzip : извлечь ZIP-файл

        Извлеките ZIP-файл в рабочую область.

        Имя/путь архивного файла для извлечения.

        Укажите, какой набор символов вы хотите использовать, например. UTF-8

        Путь к базовому каталогу, в который следует распаковать ZIP-файл. Оставьте пустым для извлечения в текущий рабочий каталог.

        • Тип: строка
        • Тип: строка

        Шаблон файлов в стиле Ant для извлечения из архива. Оставьте пустым, чтобы включить все файлы и каталоги.

        Подавить подробный вывод, который регистрирует каждый файл, с которым работают. Например, разархивировать zipFile: 'example.zip', quiet: true

        Прочитайте содержимое файлов в карту, а не записывайте их в рабочую область. Ключами карты будут пути к прочитанным файлам. Например, def v = unzip zipFile: 'example.zip', glob: '*.txt', read: true String version = v['version.txt']

        Проверьте целостность архива, а не извлекайте его. Если этот параметр включен, все остальные параметры (кроме zipFile) будут игнорироваться. Шаг вернет значение true или false в зависимости от результата, а не вызовет исключение.

        verifySha1: проверить SHA1 данного файла

        Проверяет SHA1 данного файла.

        Путь к файлу для хеширования.

        Ожидаемый хеш.

        verifySha256: проверить SHA256 данного файла

        Проверяет SHA256 данного файла.

        Путь к файлу для хеширования.

        Ожидаемый хеш.

        writeCSV: запись содержимого в CSV-файл в рабочей области.

        Запишите файл CSV в текущий рабочий каталог. Это, например, ранее было прочитано readCSV . Подробнее см. в CSVPrinter.

        • records : список экземпляров CSVRecord для записи.
        • file : путь к файлу в рабочей области для записи.
        • формат : подробности см. в формате CSVFormat.

        Пример:

        writeJSON : запись JSON в файл в рабочей области.

        Записать JSON в файл в текущем рабочем каталоге или в строку.

        • json : Объект для записи. Может быть либо экземпляром JSON, либо другой реализацией Map/List. Оба поддерживаются.
        • file (необязательно): необязательный путь к файлу в рабочей области для записи. Если указано, значение returnText должно быть ложным или опущено. Необходимо указать либо файл, либо значение returnText равно true .
        • pretty (необязательно): украсьте вывод, добавив указанное количество пробелов к каждому уровню отступа.
        • returnText (необязательно): возвращает JSON в виде строки вместо записи в файл. По умолчанию false. Если true , файл указывать не нужно. Необходимо указать либо файл, либо значение returnText равно true .

        Пример:
        Запись в файл:

        Запись в строку:

        • json
          • Тип: объект
          • Тип: строка
          • Тип: целое
          • Тип: логический

          writeMavenPom: запись файла проекта maven.

          Записывает файл проекта Maven. Это, например, ранее было прочитано readMavenPom .

          • model : объект Model для записи.
          • file : Дополнительный путь к файлу в рабочей области для записи. Если оставить поле пустым, шаг будет записан в файл pom.xml в текущем рабочем каталоге.

          Пример:

          Избегайте использования этого шага и читайте MavenPom . Для запуска целей mvn лучше использовать шаг sh: Например:

          • модель
            • Тип: класс org.apache.maven.model.Model
            • Тип: строка

            writeYaml: написать yaml из объекта или объектов.

            Записывает yaml в файл в текущем рабочем каталоге или строку из объекта или строки. Он использует SnakeYAML в качестве процессора YAML. Вызов завершится ошибкой, если файл уже существует.

            • file (необязательно): необязательный путь к файлу в рабочей области для записи данных YAML. Если указано, значение returnText должно быть ложным или опущено. Необходимо указать либо файл, либо значение returnText равно true .
            • data (необязательно): необязательный объект, содержащий данные для сериализации. Вы должны указать data или datas , но не оба в одном и том же вызове.
            • datas (необязательно): необязательная коллекция, содержащая данные для сериализации в виде нескольких документов YAML. Вы должны указать data или datas , но не оба в одном и том же вызове.
            • кодировка (необязательно): при необходимости укажите кодировку, которая будет использоваться при записи файла. По умолчанию используется UTF-8, если не указано иное. Какие наборы символов доступны, зависит от вашей основной системы Jenkins. Спецификация Java говорит нам, что должно быть доступно как минимум следующее:
              • US-ASCII
              • ИСО-8859-1
              • UTF-8
              • UTF-16BE
              • UTF-16LE
              • UTF-16

              Примеры:
              Запись в файл:

              Запись в строку: