# Развёртывание на GigaSPOT

Размещения на GigaSPOT могут быть выполнены только через API GigaSPOT (<https://gigaspot-api-docs.clore.ai/>), сначала вам нужно сгенерировать API-ключ для вашей учётной записи clore.ai

Это было выбрано потому, что GigaSPOT — это инструмент для профессионалов, и в такой высококонкурентной среде имеет смысл управлять заказами GigaSPOT только с помощью ботов.

GigaSPOT не предлагает проброс портов для своих заказов. Если вам нужно получить доступ к внутренним портам внутри контейнера, я могу рекомендовать реализовать [FRP](https://github.com/fatedier/frp) внутри вашей рабочей нагрузки

Срок жизни заказа определяется количеством времени, на которое хостинг-провайдер разрешил аренду машины. Срок жизни заказа ограничен 20 днями. Эти данные возвращаются в снимке рынка, описанном [здесь](https://gigaspot-api-docs.clore.ai/get-market-12836589e0)

***

## Развёртывание из CLORE Container Registry (CCR)

<figure><img src="https://1059281095-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyNlC5NV8aIpXnc76G7w%2Fuploads%2FCcpJccGgWg0QKj5c648K%2Fimage.png?alt=media&#x26;token=27232ab8-216f-45cf-b7f4-a97d6dedb5e2" alt=""><figcaption></figcaption></figure>

Сначала вам нужно кэшировать образ из [dockerhub](https://hub.docker.com/) в CCR; в настоящее время установлен лимит (600 МБ) на один образ, что делает это подходящим для нагрузок типа PoW. Это сделано для того, чтобы GigaSPOT был справедлив ко всем, не замедлялся из-за кэширования больших образов и позволял подавляющему большинству машин подключаться к GigaSPOT. Если у вас есть нагрузка, которая могла бы выиграть от GigaSPOT, не помещается в 600 МБ и вы ожидаете тратить на GigaSPOT более 20000$/месяц, пожалуйста, напишите <marketing@clore.ai>

[⚠️](https://www.pinterest.com/pin/what-does-the-warning-emoji-mean--885661082950897478/) Лимит 600 МБ относится к несжатому образу, поэтому после сборки образа вы можете увидеть несжатый размер в `docker image ls`

Образ в CCR имеет TTL (Time To Live) по умолчанию 30 дней; счётчик сбрасывается при развёртывании нового заказа GigaSPOT с образом из CCR. Это нужно для автоматической очистки CCR от более не нужных образов.

***

## Развёртывание из базовых образов

Некоторые образы, созданные CLORE.AI, уже кэшированы на наших машинах, поэтому клиенты могут использовать их на маркетплейсе GigaSPOT

[⚠️](https://www.pinterest.com/pin/what-does-the-warning-emoji-mean--885661082950897478/) Гарантировать, что базовый образ будет всегда оставаться прежним, нельзя; образы будут автоматически обновляться в будущем до более новых версий своего базового образа. Будущие изменения базовых образов командой clore.ai будут по возможности вноситься так, чтобы не сломать никакие рабочие нагрузки, но всё же ваша нагрузка может потерять поддержку, когда, скажем, базовые образы в дальнейшем будут обновлены до более новой версии Ubuntu через несколько лет. Обновления базовых образов будут заранее объявляться в соцсетях clore.ai, так что если вы подписаны, вы будете в курсе

### 1. Ubuntu 24.04

У этого образа CCR ID `a3f9c4d7e5b088d8a0bff880`

В настоящее время используется базовый образ [cloreai/jupyter:ubuntu24.04-v2](https://hub.docker.com/repository/docker/cloreai/jupyter/tags/ubuntu24.04-v2/sha256-0586bbd2c26a8bcfd194d9d022ce4966ede23b3a743471032069c1f2ed2abc27) с исходником по адресу <https://gitlab.com/cloreai-public/containers/jupyter>

При развёртывании этого образа внутри контейнера у вас по умолчанию будет 650 МБ свободного места для настройки вашей рабочей нагрузки

Этот образ позволяет развёртывать ваши рабочие нагрузки, указав bash-скрипт, который будет загружен при первом запуске образа

Вы можете вдохновиться этим примером для майнинга CLORE Blockchain с использованием [t-rex](https://github.com/trexminer/T-Rex) в [vipor.net](https://vipor.net/connect/clore) пуле майнинга

<https://gitlab.com/cloreai-public/gigaspot-examples/ubuntu-base-mining/-/blob/main/example-clore-blockchain.sh>

Вызов API для создания заказа с этим примером, ставка 13 CLORE/день без принудительного OC, ограничение мощности 350 Вт

В этом образе используется ENV-переменная `DELEGATED_ENTRYPOINT` как источник для загрузки скрипта. Скрипт будет загружен один раз и будет запускаться при каждом старте контейнера, поэтому убедитесь, что ваш скрипт спроектирован так, чтобы его можно было завершить в любой момент, даже на этапе первоначального развёртывания. GigaSPOT — это быстро меняющаяся торговая среда, где ваш заказ могут перебить даже во время выполнения инициализации вашего скрипта, поэтому надёжный код очень полезен.

Пример вызова API для развёртывания

```bash
curl -X POST \\
  -H 'auth: NXj2bHUXHwzvd5-Lm6UfvgGtnNwaHxLu' \\
  -H 'Content-Type: application/json' \\
  -d '[
    {
      "currency": "CLORE-Blockchain",
      "image": "a3f9c4d7e5b088d8a0bff880",
      "renting_server": 40329,
      "price": 13,
      "oc": [
        {
          "pl": 350
        }
      ],
      "env": {
        "DELEGATED_ENTRYPOINT": "https://gitlab.com/cloreai-public/gigaspot-examples/ubuntu-base-mining/-/raw/main/example-clore-blockchain.sh",
        "WORKER_NAME": "clore-gigaspot-40329"
      }
    }
  ]' \\
  'https://api.clore.ai/v1/create_gigaspot_orders'
```

В примере вы можете увидеть ENV `WORKER_NAME` который используется для настройки имени воркера для майнера, потому что оно передаётся майнеру [здесь](https://gitlab.com/cloreai-public/gigaspot-examples/ubuntu-base-mining/-/blob/main/example-clore-blockchain.sh?ref_type=heads#L78)

Этот пример в реальности не работал при развёртывании на машине #40329 из-за сетевых ограничений у некоторых ISP

### 2. HiveOS

У этого образа CCR ID `c9a4e2f6b7d488d8f0bab0ff`

В настоящее время используется базовый образ [cloreai/hiveos:0.3](https://hub.docker.com/repository/docker/cloreai/hiveos/tags/0.3/sha256-8bb62bb715bbbb9fe46fa6f529815afaed11fa60d513c7a33e8bc14d4dc87f17) с исходником по адресу <https://gitlab.com/cloreai-public/containers/hiveos>

При развёртывании этого образа внутри контейнера у вас по умолчанию будет 650 МБ свободного места для настройки вашей рабочей нагрузки

Этот образ используется для развёртывания HiveOS на Clore GigaSPOT; такое развёртывание возможно, но для крупномасштабных операций не особо рекомендуется, хотя для отладки это отлично подходит благодаря [Hive Shell](https://hiveon.com/knowledge-base/guides/hshell/) также может быть полезен для новичков при настройке рабочих нагрузок на GigaSPOT благодаря своему интерфейсу.

Для развёртывания HiveOS вам нужно создать учётную запись HiveOS и использовать для каждой арендованной машины уникальные `Rig ID` и `Password` которые являются полями, генерируемыми HiveOS для подключения машин

Эти поля вводятся через ENV, посмотрите этот пример:

```bash
curl -X POST \\
  -H 'auth: NXj2bHUXHwzvd5-Lm6UfvgGtnNwaHxLu' \\
  -H 'Content-Type: application/json' \\
  -d '[
    {
      "currency": "CLORE-Blockchain",
      "image": "c9a4e2f6b7d488d8f0bab0ff",
      "renting_server": 40329,
      "price": 13,
      "oc": [
        {
          "pl": 350
        }
      ],
      "env": {
        "rig_id": "10452701",
        "rig_pass": "UTA2xoxo"
      }
    }
  ]' \\
  'https://api.clore.ai/v1/create_gigaspot_orders'
```

Также при запуске HiveOS учтите, что на некоторых машинах подключения к определённым endpoint'ам пулов могут быть ограничены в зависимости от ISP

## Выселение заказов

На один рынок gigaspot (машину) может быть только 8 заказов (ставок). Если на машину присутствует больше заказов, заказ с наименьшей прибыльностью отменяется в биллинговом интервале CLORE.AI

## Напоследок

Хотя GigaSPOT — мощный инструмент, он лучше всего подходит пользователям Linux и людям с глубоким пониманием того, что может происходить в таких средах, и которые могут представить потенциальные риски.

На мой взгляд, лучшая практика — обязательно проверять результаты работы машины; ваша система в идеале должна проверять скорость обработки / хешрейт машин, а также иметь список машин с плохой производительностью и хостов, чтобы предотвращать финансовые потери.

GigaSPOT предоставляется как есть; ни в каких случаях, включая неверно сообщённые GPU, возвраты средств не будут выполнены. Клиент несёт ответственность за проверку производительности машины и создание чёрного списка.

Эта статья касается только создания заказов gigaspot; чтобы редактировать их, изменять настройки разгона, вам следует обратиться к [Документации API GigaSPOT](https://gigaspot-api-docs.clore.ai/)

Обратите внимание, что на некоторых машинах могут быть сетевые ограничения на уровне ISP, которые могут влиять на подключение к определённым endpoint'ам
