Команда импорта в интерфейсе командной строки импортирует пакет, включающий в себя приложения и связанные с ними схемы элементов и профили развертывания, внешние службы, политики, репозитории артефактов, службы, логические шаблоны и доступные настраиваемые задачи, из одного экземпляра Application Services в другой.

Импортировать можно только пакеты, созданные при помощи команды экспорта. Импортировать измененный пакет или пакет, созданный другим способом, невозможно.

Чтобы импортировать объекты, требуется членство в бизнес-группе, к которой эти объекты принадлежат.

При выполнении команды импорта весь пакет импортируется на конечный сервер. Нельзя выборочно импортировать объекты из пакета.

Внешние службы с одинаковыми именами нельзя импортировать в разные бизнес-группы. Кроме того, нельзя импортировать внешнюю службу как зависимость, если она принадлежит другой бизнес-группе.

  • Убедитесь, что приложение, которое содержало профиль развертывания в исходном устройстве, является общим приложением или что им владеет целевая группа на целевом устройстве. Импорт профиля развертывания в частное приложение, не принадлежащее к целевой группе, не поддерживается.
  • При импорте убедитесь, что схема элементов, на основе которой создан профиль развертывания, не изменена. Даже при незначительном изменении схемы элементов пропадает возможность сопоставлять узлы и компоненты.

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

Для успешного завершения импорта необходимо, чтобы объекты пакета содержали только символы ASCII.

Команда для импорта пакета

Формат команды для импорта пакета в интерфейсе командной строки указан ниже.

import-package --importFilePath путь --targetGroup имя бизнес-группы-владельца --ConflictResolutionAction действие

В таблице ниже описаны обязательные параметры команды импорта.

Параметр команды Описание
import-package Имя команды для импорта пакета.
--importFilePath путь Указывает расположение импортируемого пакета. Например, --importFilePath /home/dev/joomla.zip указывает расположение и имя импортируемого пакета joomla.zip.
--targetGroup имя бизнес-группы Указывает бизнес-группу, к которой принадлежит импортируемый объект. Политики исключены. Любой пользователь арендатора имеет доступ к политике, поэтому бизнес-группа, к которой принадлежит объект, игнорируется.
--ConflictResolutionAction действие Указывает действие по разрешению конфликта: CHECK, SKIP, OVERWRITE или IMPORTASNEW. Команда импорта должна содержать одно действие по разрешению конфликта.

В таблице ниже перечислены действия по разрешению конфликтов, к которым следует прибегать при импорте объектов в пакете импорта.

Действие по разрешению конфликта Описание
CHECK Перечисляет все объекты в пакете импорта и определяет, какие из них существуют в конечном расположении. Сравнивает имена объектов и идентификаторы версий с целью обнаружения совпадений. Идентификатор версии имеет следующий формат: основной номер.промежуточный номер.номер микровыпуска.квалификатор (например, 2.0.1.бета).
SKIP

Ели объект не существует в конечном расположении, копирует объект из пакета. Ели объект существует, объект из пакета не копируется. Скопированный объект принадлежит бизнес-группе, заданной параметром --TargetGroup.

OVERWRITE Если объект существует в конечном расположении, перезаписывает содержимое объекта содержимым из пакета. Копирует объект, который не существует в конечном расположении, в бизнес-группу, заданную параметром --TargetGroup. Вошедший пользователь должен быть участником бизнес-группы, к которой принадлежат импортируемые объекты.
IMPORTASNEW Копирует объект из пакета в конечное расположение. Если объект уже существует, копируемому объекту назначается новое имя. Новый объект принадлежит бизнес-группе, заданной параметром --TargetGroup. Для переименования объектов необходимо задать суффикс. Суффикс задается при помощи параметра --suffix.

В таблице ниже описаны доступные параметры команды.

Параметр команды Описание
--shared

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

--suffix текст sfx Добавляет подчеркивание и текст, указанный вместо sfxtext, к концу имени каждого скопированного объекта, копия которого существует в конечном расположении. Например, если задать параметр --suffix NEW и скопировать из пакета объект apache:1.0.0, новым именем объекта будет apache _NEW, а его версией — 1.0.0. Бизнес-группа, которой принадлежит новый объект, является целевой группой, заданной параметром --targetGroup.

SKIP и OVERWRITE

import-package --importFilePath /home/dev/dukes.zip --conflictResolutionAction SKIP --targetGroup Development
import-package --importFilePath /home/dev/dukes.zip --conflictResolutionAction OVERWRITE --targetGroup Development