# 在 GigaSPOT 上部署

GigaSPOT 上的部署只能通过 GigaSPOT API（<https://gigaspot-api-docs.clore.ai/>），首先你需要为你的 clore.ai 账户生成 API 密钥

之所以这样选择，是因为 GigaSPOT 是为专业人士设计的工具，在这种高度竞争的环境中，由机器人来管理 GigaSPOT 订单才更合理。

GigaSPOT 不为其订单提供端口转发。如果你需要访问容器内部的端口，我建议你实现 [FRP](https://github.com/fatedier/frp) 在你的工作负载中

订单的生命周期由托管服务提供商允许机器被租用的时长决定。订单生命周期最多限制为 20 天。此数据会在如下所述的市场快照中返回 [这里](https://gigaspot-api-docs.clore.ai/get-market-12836589e0)

***

## 从 CLORE 容器镜像仓库（CCR）部署

<figure><img src="https://1308073318-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。目前每个镜像有一个限制（600MB），这使其适用于 PoW 类型的工作负载。这样做是为了确保 GigaSPOT 对所有人都公平，不会因为缓存大镜像而变慢，并让绝大多数机器能够连接到 GigaSPOT。如果你的工作负载可以从 GigaSPOT 中受益，但无法塞进 600MB，并且你预计在 GigaSPOT 上每月花费超过 20000 美元，请联系 <marketing@clore.ai>

[⚠️](https://www.pinterest.com/pin/what-does-the-warning-emoji-mean--885661082950897478/) 600MB 的限制针对的是未压缩镜像，因此在构建镜像后，你可以在 `docker image ls`

CCR 上的镜像默认 TTL（存活时间）为 30 天；当你使用该 CCR 镜像创建新的 GigaSPOT 订单时，计时器会重置。这样可以自动清理 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>

将此镜像部署到容器中后，默认会有 650MB 的可用空间用于设置你的工作负载

此镜像允许你通过指定 bash 脚本来部署工作负载，该脚本会在镜像首次启动时下载

你可以参考这个在 [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/天出价，不强制超频，功率限制为 350W

此镜像使用 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` 它用于配置矿工的 worker 名称，因为它会传递给矿工 [这里](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>

将此镜像部署到容器中后，默认会有 650MB 的可用空间用于设置你的工作负载

这个镜像用于在 Clore GigaSPOT 上部署 HiveOS，这种部署是可行的，但对于大规模操作并不太推荐；不过由于 [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 时请注意，某些机器到特定矿池端点的连接可能会因 ISP 而受限

## 订单驱逐

每个 gigaspot 市场（机器）最多只能有 8 个订单（出价）。如果某台机器上的订单更多，则在 CLORE.AI 计费间隔内，盈利最低的订单会被取消

## 最后的话

虽然 GigaSPOT 是一个强大的工具，但它最适合 Linux 用户以及对这类环境中可能发生的情况有深入理解、能够预见潜在风险的人。

在我看来，最佳实践是强制验证机器的输出，你的系统最好能够验证机器的处理速度 / 算力，并最好有一份表现不佳的机器和主机名单，以防止财务损失。

GigaSPOT 按“原样”提供，在任何情况下，包括 GPU 被错误报告，均不提供退款。客户有责任验证机器性能并建立黑名单。

本文只讲如何创建 gigaspot 订单；要编辑它们、修改超频设置，你应该查看 [GigaSPOT API 文档](https://gigaspot-api-docs.clore.ai/)

请注意，某些机器可能具有 ISP 级网络限制，这会影响与某些端点的连接
