Облачная платформаEvolution

Подключение к инстансу Nessie c помощью утилиты Nessie CLI


С помощью этого руководства вы научитесь подключаться к инстансу Nessie c помощью консольной утилиты Nessie CLI.

Вы будете использовать следующие сервисы:

  • Managed Metastore — сервис для хранения и управления метаданными из разных источников.

  • «Виртуальные машины» — сервис, в рамках которого предоставляется виртуальная машина.

Шаги:

Перед началом работы

Располагайте создаваемые сущности в одной VPC и используйте единые сетевые параметры.

  1. Если вы уже зарегистрированы, войдите под своей учетной записью.

  2. Создайте бакет Object Storage, в котором будут храниться данные.

  3. Создайте sNAT-шлюз. Он необходим для обновления пакетов на виртуальной машине.

  4. Создайте кластер Data Platform с названием dp-labs.

    1. В блоке Общие параметры в поле Кластер укажите dp-labs.

    2. В блоке Настройки хранилища выберите Object Storage. Укажите созданный ранее бакет Object Storage.

  5. Дождитесь, когда статус инстанса изменится на «Готов» и откройте карточку инстанса. Информация из нее понадобится на следующих этапах.

1. Подготовьте виртуальную машину

На этом шаге вы создадите и настроите виртуальную машину.

  1. Создайте виртуальную машину. В блоке Сетевой интерфейс выберите Подсеть. Укажите VPC и подсеть, выбранные при создании инстанса Nessie.

  2. Проверьте доступные обновления:

    sudo apt update
  3. Обновите установленные пакеты до последних версий:

    sudo apt upgrade
  4. Установите Java:

    sudo apt install openjdk-11-jre-headless -y
  5. Скачайте root-сертификат dp-cert.crt:

    curl -s -O https://xbox.cloud.ru/s/wEso6nB7bKYxkkf/download/dp-cert.crt
  6. Выполните команду:

    keytool -importcert \
    -file ./cert/dp-cert.crt \
    -alias internal-nessie-ca \
    -keystore nessie-truststore.jks \
    -storepass changeit
  7. Выполните команду:

    java \
    -Djavax.net.ssl.trustStore=nessie-truststore.jks \
    -Djavax.net.ssl.trustStorePassword=changeit \
    -jar nessie-cli.jar

2. Установите утилиту Nessie CLI

На этом шаге вы запустите утилиту Nessie CLI на виртуальной машине и установите соединение с инстансом Nessie.

  1. Скачайте утилиту Nessie CLI с официального сайта:

    curl -L -o nessie-cli-0.107.6.jar \
    https://github.com/projectnessie/nessie/releases/download/nessie-0.107.6/nessie-cli-0.107.6.jar
  2. Запустите утилиту:

    java -jar nessie-cli-0.107.6.jar
  3. Установите соединение с инстансом:

    CONNECT TO <nessie-API> USING "nessie.http-redirects"="ALWAYS"

    Вместо <nessie-API> подставьте внутренний Nessie API из карточки созданного ранее инстанса Nessie.

3. Проверьте работу утилиты

На этом шаге вы проверите работу утилиты, отправив с ее помощью команды в инстанс Nessie.

  1. Получите список всех именованных ссылок:

    LIST REFERENCES
  2. Создайте новую ветку newbranch:

    CREATE BRANCH newbranch
  3. Чтобы убедиться, что в списке ссылок появилась новая ветка, получите его повторно:

    LIST REFERENCES

Результат

Вы запустили на виртуальной машине утилиту Nessie CLI, с помощью которой подключились к инстансу Nessie и проверили выполнение команд.