Экспорт и импорт данных Transformation Advisor через конечные точки HTTP

При таком способе не нужно находить и копировать данные в поде CouchDB, поэтому он может применяться в следующих случаях:

Transformation Advisor настроен для использования динамически предоставляемых ресурсов хранения.
Необходимо экспортировать только определенные фрагменты данных.
Необходимо экспортировать данные из старой версии Transformation Advisor, работающей в IBM Cloud Private, и импортировать их в более позднюю версию Transformation Advisor, работающую в OpenShift Container Platform.

Как экспортировать данные из Transformation Advisor в OpenShift Container Platform

Следуя инструкциям из руководства Использование API Transformation Advisor, получите маркер пользователя для идентификации и интерактивный пользовательский интерфейс для конечных точек OpenAPI.

Этот способ также применим к конечным точкам, открытым на веб-сервере TA, которые отличаются от конечных точек OpenAPI. Для того чтобы определить URL этих конечных точек:

Откройте пользовательский интерфейс консоли OpenShift Container Platform.
Выберите Home (Главная) > Projects (Проекты) и выберите проект Transformation Advisor.
Выберите Networking (Сеть) > Routes (Маршруты) и выберите 'server-route'.
Используйте функцию поиска расположения, которая сообщит значение для <TA_WEB_SERVER> (такое как https://ta-apps.apps.myinstance.host.com/lands_advisor)

Для экспорта исходных файлов zip отчетов, созданных компонентом сборщика данных и переданных в набор из рабочей области Transformation Advisor:

Определите значение workspaceId рабочей области, используя конечную точку OpenAPI GET /advisor/v2/workspaces
Определите значение collectionId набора, используя конечную точку OpenAPI GET /advisor/v2/workspaces/{workspaceId}/collections
Получите список файлов и сами файлы следующим образом:

Для получения списка исходных файлов zip отчетов введите следующую команду, указав правильные значения маркера пользователя, workspaceId, collectionId, имени профайла и <TA_WEB_SERVER>:

wget --header="Authorization: Bearer <USER_TOKEN>" --header="workspace:<WORKSPACE_ID>" --header="collection:<COLLECTION_ID>" --header="profileName:<PROFILE_NAME>" "<TA_WEB_SERVER>/lands_advisor/advisor/task/profile/attachment/list" --no-check-certificate

Для получения определенного файла zip из возвращенного списка выполните следующую команду, заменив значение <FILE_NAME> и других полей:

wget --header="Authorization: Bearer <USER_TOKEN>" --header="workspace:<WORKSPACE_ID>" --header="collection:<COLLECTION_ID>" --header="profileName:<PROFILE_NAME>" --header="fileName:<FILE_NAME>" "<TA_WEB_SERVER>/lands_advisor/advisor/task/profile/attachment" --no-check-certificate

Будет возвращен файл с именем attachment, который можно переименовать по своему усмотрению.
Для получения списка зависимостей приложения, переданных в план миграции определенного приложения, выполните следующую команду, заменив значение <APP_NAME> и других полей:

wget --header="Authorization: Bearer <USER_TOKEN>" --header="workspace:<WORKSPACE_ID>" --header="collection:<COLLECTION_ID>" --header="profileName:<PROFILE_NAME>" --header="appName:<APP_NAME>" "<TA_WEB_SERVER>/lands_advisor/advisor/task/profile/attachment/list" --no-check-certificate

Для получения определенного файла зависимостей из возвращенного списка выполните следующую команду, заменив значение <FILE_NAME> и других полей:

wget --header="Authorization: Bearer <USER_TOKEN>" --header="workspace:<WORKSPACE_ID>" --header="collection:<COLLECTION_ID>" --header="profileName:<PROFILE_NAME>" --header="appName:<APP_NAME>" --header="fileName:<FILE_NAME>" "<TA_WEB_SERVER>/lands_advisor/advisor/task/profile/attachment" --no-check-certificate

Будет возвращен файл с именем attachment, который можно переименовать по своему усмотрению.

Как экспортировать данные из Transformation Advisor в TA-LOCAL

В случае TA-LOCAL следует выполнить указанную выше процедуру за следующим исключением:

Не нужно получать маркер пользователя для идентификации.
Удалите фрагмент --header="Authorization: Bearer <USER_TOKEN>" из всех команд.
В качестве <TA_WEB_SERVER> используйте значение <TA_LOCAL_UI_HOST>:2220/lands_advisor

Как экспортировать данные из Transformation Advisor в IBM Cloud Private

Если Transformation Advisor развернут в IBM Cloud Private, следует выполнить ту же процедуру, что и при экспорте данных из Transformation Advisor в OpenShift Container Platform, за следующим исключением:

Для того чтобы определить значение <TA_WEB_SERVER> с помощью пользовательского интерфейса IBM Cloud Private, выполните следующие действия:

Откройте пользовательский интерфейс консоли IBM Cloud Private
Перейдите к выпуску IBM Cloud Transformation Advisor Helm
В действии 'launch' будет предложено два варианта - выберите сервер
Этот URL следует использовать как значение <TA_WEB_SERVER>

Для получения доступа к API вам потребуется ключ API, процедура создания которого описана здесь

Для того чтобы определить значения workspaceId и collectionId на шагах 1 и 2, откройте пользовательский интерфейс Transformation Advisor, выберите рабочую область, а затем - набор, в который был передан исходный файл zip, и определите значения с помощью URL страницы. Например, в URL вида https://ta-apps.apps.myinstance.host.com/recommendations?profileName=AppSrv02&collection=2cc1b1f8-b65e-47a1-9ad6-fcb03f1c4323&workspace=83918944-2873-4209-8f3c-476de46b1f64 значение workspaceId равно 83918944-2873-4209-8f3c-476de46b1f64, а значение collectionId равно 2cc1b1f8-b65e-47a1-9ad6-fcb03f1c4323.

Определив эти значения, перейдите к шагу 3 и выполните команды для получения списка файлов и самих файлов.

Как импортировать данные в Transformation Advisor в OpenShift Container Platform или TA-LOCAL

Проще всего передать экспортированные файлы через пользовательский интерфейс целевого экземпляра Transformation Advisor.

В качестве альтернативы исходные архивы отчетов и файлы зависимостей приложения можно передать через конечную точку HTTP, выполнив следующие действия:

В целевом экземпляре Transformation Advisor перейдите в рабочую область, а затем - в набор, куда нужно передать файлы.
Выберите 'Варианты передачи данных', а затем - 'Передать данные через сборщик данных'
Загрузите сборщик данных для своей платформы, распакуйте загруженный файл и получите uploadKey из файла uploadEndpoint.json
Для передачи исходных архивов отчетов откройте интерактивный пользовательский интерфейс конечных точек OpenAPI и используйте следующий метод REST: POST /lands_advisor/advisor/v2/workspaces/{workspaceId}/collections/{collectionId}/collectionArchives
Для передачи файлов зависимостей приложения выполните следующую команду, указав соответствующие значения во всех полях:

curl -k -X POST "<TA_WEB_SERVER>/lands_advisor/advisor/task/profile/attachment" -H  "accept: */*" -H "collection:<COLLECTION_ID>" -H "workspace:<WORKSPACE_ID>" -H "profileName:<PROFILE_NAME>" -H "appName:<APP_NAME>" -H "fileName:<FILE_NAME>" -H "description:APPLICATION" -H  "Authorization: Bearer <USER_TOKEN>" -H  "Content-Type:application/octet-stream"  --data-binary @<ABSOLUTE_PATH_TO_FILE>