Database Upgrade

Введение

В этом документе описан API, используемый для обновления базы данных Odoo до более высокой версии.

Он позволяет обновить базу данных без повторной отправки html-формы на https://upgrade.odoo.com Хотя база данных будет следовать тому же процессу, который описан в этой форме.

Требуемые шаги:

создание запроса
выгрузка дампа базы данных
запуск процесса обновления
получение статуса запроса базы данных
загрузка обновленного дампа базы данных

Методы

Создание запроса на обновление базы данных

Это действие создает запрос базы данных со следующей информацией:

Ссылка на ваш контракт
Ваш адрес электронной почты:
Целевую версию (версию Odoo, до которой вы хотите обновить)
Цель вашего запроса (для теста или реальная эксплуатация)
Имя дампа базы данных (обязательное, но чисто для информации)
необязательный параметр - часовой пояс сервера (для версии Odoo <6.1)

Метод `create`

`https://upgrade.odoo.com/database/v1/create`

Создает запрос на обновление базы данных

Параметры

contract (str) – (обязательный параметр) ссылка на ваш контракт enterprise версии
email (str) – (обязательный параметр) ваш адрес электронной почты
target (str) – (required) the Odoo version you want to upgrade to. Valid choices: 10.0, 11.0, 12.0
aim (str) – (обязательный параметр) цель вашего запроса обновления базы данных . Доступные значения: тест, реальная эксплуатация.
filename (str) – (обязательный параметр) имя дампа базы данных , носит информационный характер
timezone (str) – (необязательный параметр) часовой пояс, используемый вашим сервером. Только для версии Odoo <6.1

Результат

Результат запроса

Тип результата

JSON dictionary

Метод create возвращает словарь JSON, содержащий следующие ключи:

`failures`

Список ошибок.

Список словарей, каждый из которых содержит информацию об одной конкретной ошибке. Каждый словарь может содержать различные ключи в зависимости от типа ошибки, но вы всегда получите ключи reason и message:

reason: тип ошибки
message: понятное человеку сообщение

Некоторые возможные ключи:

code: ошибочное значение
value: ошибочное значение
expected: список допустимых значений

См. Пример вывода.

JSON

{
  "failures": [
    {
      "expected": [
        "10.0",
        "11.0",
        "12.0",
      ],
      "message": "Invalid value \"5.0\"",
      "reason": "TARGET:INVALID",
      "value": "5.0"
    },
    {
      "code": "M123456-abcxyz",
      "message": "Can not find contract M123456-abcxyz",
      "reason": "CONTRACT:NOT_FOUND"
    }
  ]
}

`request`

Если вызов метода create будет успешным, значение, связанное с ключом request, будет словарем, содержащим различную информацию о созданном запросе:

Наиболее важные ключи:

id: id запроса
key: ваш личный ключ для этого запроса

Эти 2 значения будут запрошены другими методами (upload, process и status)

Другие ключи будут объяснены в разделе, описывающем status method.

Пример скрипта

Вот два примера создания запроса на обновление базы данных с использованием:

one in the python programming language using the requests library
one in the bash programming language using curl (tool for transfering data using http) and jq (JSON processor):

Python 2
Bash

import requests

CREATE_URL = "https://upgrade.odoo.com/database/v1/create"
CONTRACT = "M123456-abcdef"
AIM = "test"
TARGET = "12.0"
EMAIL = "john.doe@example.com"
FILENAME = "db_name.dump"

fields = dict([
    ('aim', AIM),
    ('email', EMAIL),
    ('filename', DB_SOURCE),
    ('contract', CONTRACT),
    ('target', TARGET),
])

r = requests.get(CREATE_URL, data=fields)
print(r.text)

CONTRACT=M123456-abcdef
AIM=test
TARGET=12.0
EMAIL=john.doe@example.com
FILENAME=db_name.dump
CREATE_URL="https://upgrade.odoo.com/database/v1/create"
URL_PARAMS="contract=${CONTRACT}&aim=${AIM}&target=${TARGET}&email=${EMAIL}&filename=${FILENAME}"
curl -sS "${CREATE_URL}?${URL_PARAMS}" > create_result.json

# check for failures
failures=$(cat create_result.json | jq -r '.failures[]')
if [ "$failures" != "" ]; then
  echo $failures | jq -r '.'
  exit 1
fi

Загрузка дампа базы данных

Существует два метода загрузки дампа базы данных:

метод upload с использованием протокола HTTPS
метод `` request_sftp_access`` с использованием протокола SFTP

Метод `` upload``

Это самый простой и самый правильный способ загрузки дампа базы данных. Он использует протокол HTTPS.

`https://upgrade.odoo.com/database/v1/upload`

Загружает дамп базы данных

Параметры

key (str) – (обязательный параметр) ваш личный ключ
request (str) – (обязательный параметр) ваш id запроса

Результат

Результат запроса

Тип результата

JSON dictionary

Идентификатор запроса и закрытый ключ получают с помощью метод create

Результатом является словарь JSON, содержащий список failures, который должен быть пустым, если все прошло нормально.

Python 2
Bash

import requests

UPLOAD_URL = "https://upgrade.odoo.com/database/v1/upload"
DUMPFILE = "/tmp/dump.sql"

fields = dict([
    ('request', '10534'),
    ('key', 'Aw7pItGVKFuZ_FOR3U8VFQ=='),
])
headers = {"Content-Type": "application/octet-stream"}

with open(DUMPFILE, 'rb') as f:
    requests.post(UPLOAD_URL, data=f, params=fields, headers=headers)

UPLOAD_URL="https://upgrade.odoo.com/database/v1/upload"
DUMPFILE="openchs.70.cdump"
KEY="Aw7pItGVKFuZ_FOR3U8VFQ=="
REQUEST_ID="10534"
URL_PARAMS="key=${KEY}&request=${REQUEST_ID}"
HEADER="Content-Type: application/octet-stream"
curl -H $HEADER --data-binary "@${DUMPFILE}" "${UPLOAD_URL}?${URL_PARAMS}"

Метод `request_sftp_access`

Этот метод рекомендуется для больших дампов базы данных. Он использует протокол SFTP и поддерживает возобновление.

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

`https://upgrade.odoo.com/database/v1/request_sftp_access`

Создает SFTP-сервер

Параметры

key (str) – (обязательный параметр) ваш личный ключ
request (str) – (обязательный параметр) ваш id запроса
ssh_keys (str) – (обязательный параметр) путь к файлу, в котором перечислены открытые ключи ssh, которые вы хотели бы использовать

Результат

Результат запроса

Тип результата

JSON dictionary

Идентификатор запроса и закрытый ключ получают с помощью метод create

Файл с открытыми ключами ssh должен быть примерно похож на стандартный файл authorized_keys. Этот файл должен содержать только открытые ключи, пустые строки или комментарии (строки, начинающиеся с символа #),

Ваш запрос на обновление базы данных должен находиться в состоянии draft.

Метод request_sftp_access возвращает словарь JSON, содержащий следующие ключи:

Python 2
Bash

import requests

UPLOAD_URL = "https://upgrade.odoo.com/database/v1/request_sftp_access"
SSH_KEY = "$HOME/.ssh/id_rsa.pub"
SSH_KEY_CONTENT = open(SSH_KEY,'r').read()

fields = dict([
    ('request', '10534'),
    ('key', 'Aw7pItGVKFuZ_FOR3U8VFQ=='),
    ('ssh_keys', SSH_KEY_CONTENT)
])

r = requests.post(UPLOAD_URL, params=fields)
print(r.text)

REQUEST_SFTP_ACCESS_URL="https://upgrade.odoo.com/database/v1/request_sftp_access"
SSH_KEYS=/path/to/your/authorized_keys
KEY="Aw7pItGVKFuZ_FOR3U8VFQ=="
REQUEST_ID="10534"
URL_PARAMS="key=${KEY}&request=${REQUEST_ID}"

curl -sS "${REQUEST_SFTP_ACCESS_URL}?${URL_PARAMS}" -F ssh_keys=@${SSH_KEYS} > request_sftp_result.json

# check for failures
failures=$(cat request_sftp_result.json | jq -r '.failures[]')
if [ "$failures" != "" ]; then
  echo $failures | jq -r '.'
  exit 1
fi

`failures`

Список ошибок. Смотрите failures для объяснения словаря JSON, возвращенного в случае сбоя.

`request`

Если вызов выполнен успешно, значение, связанное с ключом request, будет словарем, содержащим параметры подключения SFTP:

hostname: адрес хоста для соединения
sftp_port: порт для подключения
sftp_user: пользователь SFTP, который будет использоваться для подключения
shared_file: имя файла, которое вы должны использовать (идентичное значению filename, которое вы использовали при создании запроса в метод create).)
request_id: соответствующий id запроса обновления (только информативный, не требуемый для подключения)
sample_command: пример команды с использованием клиента sftp

Обычно вы можете подключиться с использованием команды sample как есть.

У вас будет доступ только к shared_file. Никакие другие файлы не будут доступны, и вы не сможете создавать новые файлы в общей среде на сервере SFTP.

Использование клиента sftp

После успешного подключения с использованием SFTP-клиента вы можете загрузить дамп базы данных. Ниже приведен пример сеанса с использованием клиента sftp:

$ sftp -P 2200 user_10534@upgrade.odoo.com
Connected to upgrade.odoo.com.
sftp> put /path/to/openchs.70.cdump openchs.70.cdump
Uploading /path/to/openchs.70.cdump to /openchs.70.cdump
sftp> ls -l openchs.70.cdump
-rw-rw-rw-    0 0        0          849920 Aug 30 15:58 openchs.70.cdump

Если ваше соединение прервано, вы можете продолжить передачу файла, используя ключ командной строки -a:

sftp> put -a /path/to/openchs.70.cdump openchs.70.cdump
Resuming upload of /path/to/openchs.70.cdump to /openchs.70.cdump

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

echo "put /path/to/openchs.70.cdump openchs.70.cdump" | sftp -b - -P 2200 user_10534@upgrade.odoo.com

Параметр -b принимает имя файла. Если имя файла -, оно читает команды со стандартного ввода.

Запрос на обработку вашего запроса

Это действие просит платформу обновления обработать дамп базы данных.

Метод `process`

`https://upgrade.odoo.com/database/v1/process`

Обработка дампа базы данных

Параметры

key (str) – (обязательный параметр) ваш личный ключ
request (str) – (обязательный параметр) ваш id запроса

Результат

Результат запроса

Тип результата

JSON dictionary

Идентификатор запроса и закрытый ключ получают с помощью метод create

Python 2
Bash

import requests

PROCESS_URL = "https://upgrade.odoo.com/database/v1/process"

fields = dict([
    ('request', '10534'),
    ('key', 'Aw7pItGVKFuZ_FOR3U8VFQ=='),
])

r = requests.get(PROCESS_URL, data=fields)
print(r.text)

PROCESS_URL="https://upgrade.odoo.com/database/v1/process"
KEY="Aw7pItGVKFuZ_FOR3U8VFQ=="
REQUEST_ID="10534"
URL_PARAMS="key=${KEY}&request=${REQUEST_ID}"
curl -sS "${PROCESS_URL}?${URL_PARAMS}"

Asking to skip the tests

This action asks the Upgrade Platform to skip the tests for your request. If you don’t want Odoo to test and validate the migration, you can bypass the testing stage and directly get the migrated dump.

The `skip_test` method

`https://upgrade.odoo.com/database/v1/skip_test`

Skip the tests, deliver the upgraded dump, and set the state to „delivered“

Параметры

key (str) – (обязательный параметр) ваш личный ключ
request (str) – (обязательный параметр) ваш id запроса

Результат

Результат запроса

Тип результата

JSON dictionary

Идентификатор запроса и закрытый ключ получают с помощью метод create

Python 2
Bash

import requests

PROCESS_URL = "https://upgrade.odoo.com/database/v1/skip_test"

fields = dict([
    ('request', '10534'),
    ('key', 'Aw7pItGVKFuZ_FOR3U8VFQ=='),
])

r = requests.get(PROCESS_URL, data=fields)
print(r.text)

PROCESS_URL="https://upgrade.odoo.com/database/v1/skip_test"
KEY="Aw7pItGVKFuZ_FOR3U8VFQ=="
REQUEST_ID="10534"
URL_PARAMS="key=${KEY}&request=${REQUEST_ID}"
curl -sS "${PROCESS_URL}?${URL_PARAMS}"

Получение статуса запроса

Это действие запрашивает статус вашего запроса на обновление базы данных.

Метод `status`

`https://upgrade.odoo.com/database/v1/status`

Запросить статус запроса на обновление базы данных

Параметры

key (str) – (обязательный параметр) ваш личный ключ
request (str) – (обязательный параметр) ваш id запроса

Результат

Результат запроса

Тип результата

JSON dictionary

Идентификатор запроса и закрытый ключ получают с помощью метод create

Результатом является словарь JSON, содержащий различную информацию о вашем запросе на обновление базы данных.

Python 2
Bash

import requests

PROCESS_URL = "https://upgrade.odoo.com/database/v1/status"

fields = dict([
    ('request', '10534'),
    ('key', 'Aw7pItGVKFuZ_FOR3U8VFQ=='),
])

r = requests.get(PROCESS_URL, data=fields)
print(r.text)

STATUS_URL="https://upgrade.odoo.com/database/v1/status"
KEY="Aw7pItGVKFuZ_FOR3U8VFQ=="
REQUEST_ID="10534"
URL_PARAMS="key=${KEY}&request=${REQUEST_ID}"
curl -sS "${STATUS_URL}?${URL_PARAMS}"

Пример вывода

Ключ request содержит различную полезную информацию о вашем запросе:

id: ID запроса
key: Ваш личный ключ
email: Адрес электронной почты, который вы указали при создании запроса
target: Целевая версия Odoo, которую вы указали при создании запроса
aim: Цель (тест, реальное использование) запроса на обновление базы данных, которую вы указали при создании запроса
filename: Имя файла, которое вы указали при создании запроса
timezone: Часовой пояс, который вы указали при создании запроса
state: Состояние вашего запроса
issue_stage: Этап ишью, которую мы создали на главном сервере Odoo
issue: id ишью, которую мы создали на главном сервере Odoo
status_url: URL-адрес для доступа к html-странице запроса на обновление базы данных
notes_url: URL-адрес для получения заметок об обновлении базы данных
original_sql_url: URL-адрес, используемый для получения загруженной (не обновленной) базы данных в виде потока SQL
original_dump_url: URL-адрес, используемый для получения загруженной (не обновленной) базы данных в виде файла архива
upgraded_sql_url: URL-адрес, используемый для получения обновленной базы данных в виде потока SQL
upgraded_dump_url: URL-адрес, используемый для получения обновленной базы данных в виде файла архива
modules_url: URL-адрес, используемый для получения кастомных модулей
filesize: Размер файла загруженной базы данных
database_uuid: Уникальный идентификатор вашей базы данных
created_at: Дата создания запроса
estimated_time: Оценка времени, необходимого для обновления базы данных
processed_at: Время начала обновления базы данных
elapsed: Время, необходимое для обновления базы данных
filestore: Ваши вложения были преобразованы в файл-архив
customer_message: Важное сообщение, связанное с вашим запросом
database_version: предполагаемая версия Одо вашей загруженной (не обновленной) базы данных
postgresql: предполагаемая версия Postgresql загруженной (не обновленной) базы данных
compressions: Методы сжатия, используемые вашей загруженной базой данных

JSON

{
  "failures": [],
  "request": {
    "id": 10534,
    "key": "Aw7pItGVKFuZ_FOR3U8VFQ==",
    "email": "john.doe@example.com",
    "target": "12.0",
    "aim": "test",
    "filename": "db_name.dump",
    "timezone": null,
    "state": "draft",
    "issue_stage": "new",
    "issue": 648398,
    "status_url": "https://upgrade.odoo.com/database/eu1/10534/Aw7pItGVKFuZ_FOR3U8VFQ==/status",
    "notes_url": "https://upgrade.odoo.com/database/eu1/10534/Aw7pItGVKFuZ_FOR3U8VFQ==/upgraded/notes",
    "original_sql_url": "https://upgrade.odoo.com/database/eu1/10534/Aw7pItGVKFuZ_FOR3U8VFQ==/original/sql",
    "original_dump_url": "https://upgrade.odoo.com/database/eu1/10534/Aw7pItGVKFuZ_FOR3U8VFQ==/original/archive",
    "upgraded_sql_url": "https://upgrade.odoo.com/database/eu1/10534/Aw7pItGVKFuZ_FOR3U8VFQ==/upgraded/sql",
    "upgraded_dump_url": "https://upgrade.odoo.com/database/eu1/10534/Aw7pItGVKFuZ_FOR3U8VFQ==/upgraded/archive",
    "modules_url": "https://upgrade.odoo.com/database/eu1/10534/Aw7pItGVKFuZ_FOR3U8VFQ==/modules/archive",
    "filesize": "912.99 Kb",
    "database_uuid": null,
    "created_at": "2018-09-09 07:13:49",
    "estimated_time": null,
    "processed_at": null,
    "elapsed": "00:00",
    "filestore": false,
    "customer_message": null,
    "database_version": null,
    "postgresql": "9.4",
    "compressions": [
      "pgdmp_custom",
      "sql"
    ]
  }
}

Загрузка дампа базы данных

Помимо загрузки перенесенной базы данных с использованием URL-адреса, предоставленного с помощью status method, вы также можете использовать протокол SFTP, как описано в методе request_sftp_access method

Разница заключается в том, что вы сможете загружать только перенесенную базу данных. Загрузка не будет возможна.

Запрос на обновление базы данных должен находиться в состоянии done.

$ sftp -P 2200 user_10534@upgrade.odoo.com
Connected to upgrade.odoo.com.
sftp> get upgraded_openchs.70.cdump /path/to/upgraded_openchs.70.cdump
Downloading /upgraded_openchs.70.cdump to /path/to/upgraded_openchs.70.cdump

Введение

Методы

Создание запроса на обновление базы данных

Метод create

https://upgrade.odoo.com/database/v1/create

failures

request

Пример скрипта

Загрузка дампа базы данных

Метод `` upload``

https://upgrade.odoo.com/database/v1/upload

Метод request_sftp_access

https://upgrade.odoo.com/database/v1/request_sftp_access

failures

request

Использование клиента sftp

Запрос на обработку вашего запроса

Метод process

https://upgrade.odoo.com/database/v1/process

Asking to skip the tests

The skip_test method

https://upgrade.odoo.com/database/v1/skip_test

Получение статуса запроса

Метод status

https://upgrade.odoo.com/database/v1/status

Пример вывода

Загрузка дампа базы данных

Метод `create`

`https://upgrade.odoo.com/database/v1/create`

`failures`

`request`

`https://upgrade.odoo.com/database/v1/upload`

Метод `request_sftp_access`

`https://upgrade.odoo.com/database/v1/request_sftp_access`

`failures`

`request`

Метод `process`

`https://upgrade.odoo.com/database/v1/process`

The `skip_test` method

`https://upgrade.odoo.com/database/v1/skip_test`

Метод `status`

`https://upgrade.odoo.com/database/v1/status`