Отправка и продвижение пакета
Если пакет CCD готов, используйте для продолжения автоматическое развертывание сборки. Процесс автоматического развертывания сборки включает в себя организацию продвижения конфигурации и настройки в соответствии с разрешениями и ландшафтом среды.
Можно отправить сборку, выгрузив пакет CCD и файл манифеста в соответствующие расположения учетной записи хранилища. Вначале необходимо выгрузить пакет CCD в /data/builds. Вначале необходимо выгрузить пакет CCD в /data/builds/deploy.
Это действие инициирует рабочий процесс автоматического развертывания сборки. Процесс управляется заданиями уведомлений, полученными по электронной почте. Информация в сообщении электронной почты помогает выполнить различные шаги. Утверждающие задания объявляются в файле манифеста. Пример файла манифеста доступен в разделе Инициирование автоматического развертывания.
 |
В качестве предварительных условий учитывайте следующие моменты:
• Необходимо задать расположение хранилища BLOB-объектов Azure. Сведения об авторизации должны быть получены из облака PTC.
◦ PTC предоставляет URL-адрес SAS для этой задачи.
◦ Необходимо отправить запрос через портал поддержки PTC, чтобы ваш IP-адрес был указан в списке разрешенных. В подробной информации укажите постоянный IP-адрес
• Необходимо отправить запрос, чтобы конвейер был настроен соответственно значению, указанному в файле манифеста. Примеры: int1 или pipeline1. Дополнительные сведения об атрибуте deploy_pipe см. в подразделе "Создание файла манифеста" в разделе Инициирование автоматического развертывания.
|
Первым шагом рабочего процесса автоматического развертывания сборки является проверка пакета CCD. Система проверяет пакет CCD, чтобы определить его соответствие требованиям Windchill+. После проверки система генерирует отчеты и делает их доступными в учетной записи хранилища.
Отчеты и журналы можно найти в папке /data/builds/logs/<RITM Number>/. Сгенерированные файлы отчетов и журналов имеют следующий синтаксис.
• Синтаксис отчетов: cwave_<CustomerShortName>_<Date-Time>_<Control Label>.html. Здесь параметр <Control Label> может иметь значение IntakeProcessor, SpotBugs, Logs и т. д.
• Синтаксис журналов: ccd_<environment>_<Date-Time>_<ant target>_Logs.zip. Здесь параметр <ant target> может иметь значение deploy, load и т. д. Дополнительные сведения см. на веб-странице Цели.
|
Наименование отчета
|
Реализация проверок
|
|---|---|
|
cwave_<CustomerShortName>_<Date-Time>_IntakeProcessor.html
|
Проверки Windchill+ (разрешенная настройка Windchill+, неодобрение, неподдерживаемые интерфейсы API, безопасность)
|
|
cwave_<CustomerShortName>_<Date-Time>_SpotBugs.html
|
Проверка статического кода (оптимальные методы Java)
|
Обратите внимание на следующие моменты:
• Если пакет CCD не проходит какую-либо проверку, отправляется уведомление и процесс отправки останавливается.
• Если пакет CCD соответствует требованиям, процесс продолжается и сборка продвигается к целевому объекту, определенному в файле манифеста.
• После успешного развертывания сборки у вас есть семь дней для завершения тестирования.
|
|
Как клиент вы несете ответственность за содержимое пакета CCD. Отправляя сборку, вы удостоверяете, что разработка была выполнена в соответствии с правилами безопасности PTC. Дополнительные сведения о правилах безопасности PTC см. в разделе Рекомендации по настройке безопасности.
|
Правила Windchill+ для состава пакета CCD
Пакет CCD и его состав должны соответствовать конкретной структуре каталогов. Структура каталогов и содержимое файлов пакета CCD подчиняется следующим правилам:
• Размер пакета CCD не должен превышать 100 МБ.
• Пакет CCD может содержать следующие папки:
|
Папка
|
Описание
|
|---|---|
|
Configurations
|
Ни одной или одна папка Configurations
|
|
Generated
|
Ни одной или одна папка Generated
|
|
customlib
|
Ни одной или одна папка customlib
|
|
<custom module(s)>
|
Одна или несколько папок пользовательских модулей
|
|
|
В пакете CCD должна присутствовать хотя бы одна папка из этих четырех.
|
• Файл descriptor.xml должен присутствовать во всех папках пользовательских модулей пакета CCD.
• Папка Generated может быть пустой либо содержать одну или обе из следующих папок:
◦ Папка db - папка db может быть пустой. В противном случае она должна содержать файл db/conf/SchemaConfig.xml.
◦ Папка BAC - в папке BAC разрешен только один ZIP-файл BAC. Сопоставления BAC можно привести в файле Mapping.xsl, расположенном в папке BAC.
◦ Папка customlib должна содержать IP-адреса JAR-файлов партнеров, если они существуют.
• Допустимыми значениями являются plusselect и meddev.
• В пакете CCD не должно быть заблокированных или непредвиденных файлов, подчиняющихся следующим правилам:
◦ В пакете не разрешены следующие файлы: .jar, .class, .exe, .ser, .sql, .ddl, .pks, .pkb, .ora, .jasper, .cs, .cpp, .so, .dll, .jnilib, .dylib, .h, .cgf, .out, .ldif, .sh,.pl, .groovy, .gwt.xml, .gwt.modules.xml
◦ Допустимые файлы в папке xconf: .xconf
◦ Допустимые файлы в папке conf: .xml, .ini
◦ Допустимые файлы в папке resources: .tpl, .bas, .ddx, .html, .yml, .xjb, .ftl, .xml, .dtd, .xsl, .properties, .txt, .ini, .json, .js
◦ Допустимые файлы в папке src: .java, .rbInfo
◦ Допустимые файлы в папке jsp: .jsp, .jspf
◦ Допустимые файлы в папке tags: .tag, .tagf
◦ Допустимые файлы в папке tlds: .tld
◦ В папке src_web не разрешены следующие файлы: .java
◦ Допустимый путь к папке JasperReports - module/main/resources и module/main/src_web (недопустим на уровне конфигураций)
◦ Действительные файлы в папке JasperReports на пути к ресурсам - .jrxml, .jasperProperties и .properties
◦ Допустимый тип файла в папке JasperReports на пути src_web - .gif
◦ Допустимые файлы в папке customlib: .jar
◦ Папки с именем apps не разрешены в следующих папках:
▪ configurations/resources
▪ main/resources
▪ main/src_web
Эти правила проверяются при отправке пакета на развертывание. О любом несоответствии сообщается. Журналы развертывания содержат сводный отчет RITM, например RITM0910921.txt. Этот отчет содержит сводку о соответствии пакета правилам Windchill+. Пример сводного отчета RITM:
Подробные журналы RITM можно найти в ZIP-файле подробного отчета, содержащем сведения о проверке таких правил. Данный ZIP-файл включает файл журнала, предоставляющий сведения о проверке правил.
Пример ZIP-файла: RITM0910921_Reports.zip.
Пример файла журнала: preValidate_20240402-142645.log.
| | Хотя эти правила не применяются принудительно, следует отмечать любые отклонения от них и активно их исправлять. PTC будет принудительно применять некоторые из этих правил в будущем, и любое несоблюдение в дальнейшем сделает пакет недействительным. Дополнительные сведения о запрещенной настройке и предупреждениях см. в разделе Неразрешенная настройка. |
Перед готовностью к использованию конечными пользователями
Можно использовать Windchill+ без среды обеспечения качества (QA). Со средой QA можно также использовать расширения Windchill+. В зависимости от сценария можно выполнить шаги, описанные в следующих подходах:
Расширенный Windchill+ со средой QA
При использовании расширений Windchill+ Select со средой обеспечением качества (QA) выполните следующие шаги.
1. Отправьте пакет в среду интеграции для цикла тестирования интеграции и функциональной приемки. Этот цикл тестирования можно запускать часто. Например, несколько раз в неделю.
◦ Отправьте файл сборки и манифеста с расширением deploy_pipe : int.
Дополнительные сведения см. в разделе Развертывание пакета кода и конфигурации.
◦ Завершите цикл тестирования. В конце цикла тестирования задание считается выполненным и среда возвращается к предыдущему состоянию.
| | Если этот шаг не выполняется в течение семи дней, среда возвращается в предыдущее состояние. |
2. Отправьте пакет в среду QA для выполнения UAT, а затем на продвижение в производственную среду. Рекомендуется инициировать цикл тестирования UAT один или два раза в месяц, поскольку этот процесс продвигает сборку в производственную среду.
◦ Отправить файл сборки и манифеста с именем deploy_pipe : pipeline. Дополнительные сведения см. в разделе Развертывание пакета кода и конфигурации.
◦ Завершите цикл тестирования. Обратите внимание на следующие моменты:
▪ Если цикл тестирования выполнен успешно, задание утверждается и сборка продвигается в производственную среду.
▪ Если цикл тестирования не выполнен, задание отклоняется и сборка возвращается в предыдущее состояние.
▪ Если цикл тестирования не завершен в течение семи дней, среда возвращается к предыдущему состоянию.
Базовый Windchill+ без среды QA
При использовании базового Windchill+ Select без среды контроля качества (QA) выполните следующие шаги:
1. Отправить файл сборки и манифеста с именем deploy_pipe : int. Дополнительные сведения см. в разделе Развертывание пакета кода и конфигурации.
2. Завершите цикл интеграции и функциональной приемки. В конце цикла тестирования задание завершается, и среда возвращается к предыдущему состоянию.
| | Если этот шаг не выполняется в течение семи дней, среда возвращается в предыдущее состояние. |
3. Повторно отправьте ту же сборку и обновленный файл манифеста с помощью deploy_pipe : pipeline. Дополнительные сведения см. в разделе Развертывание пакета кода и конфигурации.
4. Завершите цикл тестирования пользовательской приемки в среде интеграции. Обратите внимание на следующие моменты:
◦ Если цикл тестирования выполнен успешно, задание утверждается и сборка продвигается в производственную среду.
◦ Если цикл тестирования не выполнен, задание отклоняется и сборка возвращается в предыдущее состояние.
◦ Если цикл тестирования не завершен в течение семи дней, среда возвращается к предыдущему состоянию
| | Во всех тестовых задачах используется только одна среда. Одновременно система может выполнить только одно действие тестирования. Если сборка отправлена с помощью deploy_pipe : int в этом окне, она автоматически отклоняется. |
Этап готовности к использованию конечными пользователями
После подтверждения этапа готовности к использованию конечными пользователями необходимо сменить хост-сервер производственной среды для сред обеспечения качества и интеграции.
Для этой задачи необходимо открыть запрос сервиса на портале поддержки PTC. Дополнительные сведения см. в разделе Открытие запроса сервиса.
Состояние выполнения
• После успешного перехода в состояние готовности к использованию конечными пользователями все среды получают переопределенный хост-сервер из производственной среды. Поэтому PTC настоятельно рекомендует распространить изменения на среды разработки. Рекомендуется использовать BAC и экспортировать полный пакет BAC из среды интеграции. Дополнительные сведения см. в разделе Импорт пакета BAC с использованием утилиты CCD.
Обратите внимание на следующие моменты:
◦ Экспорт модели данных является минимальным требованием для повторной сборки системы (диспетчер типов и атрибутов).
◦ Объекты, не поддерживаемые BAC, можно либо экспортировать из среды интеграции через интерфейс пользователя (если это возможно), либо воссоздать файл загрузки в среде разработки.
• После этого цикл отправки будет похож на цикл, упоминаемый в подразделе "Перед переходом в режим готовности к использованию конечными пользователями" раздела "Отправка и продвижение пакета".
• После перехода к готовности к использованию конечными пользователями необходимо сменить хост-сервер производственной среды в средах QA и интеграции. Для задач смены хоста необходимо открыть запрос сервиса. Дополнительные сведения см. в разделе Открытие запроса сервиса.
| | • После успешного начального ввода в эксплуатацию все среды (кроме среды разработки) должны быть переведены из рабочей среды. Смена хост-сервера не выполняется автоматически, и для нее требуется запрос сервиса. • Начальный ввод в эксплуатацию относится к первому развертыванию приложения в производственной среде. На этом этапе все среды нижних уровней синхронизируются с производственной средой, чтобы обеспечить согласованность и стабильность во всей среде развертывания. • Основной ввод в эксплуатацию относится к любому последующему выпуску в производственной среде после начального ввода в эксплуатацию. Эти выпуски, как правило, содержат новые возможности, улучшения или исправления и являются частью текущего цикла разработки и доставки. |