# 在 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="/files/925122136aea39407aa506dab312d4d8f197f886" 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 级网络限制，这会影响与某些端点的连接


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-zh/gigaspot/deploying-on-gigaspot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
