slot-deploy

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Slot Deploy

Slot 部署

Manage the lifecycle of Slot deployments — Katana (execution layer) and Torii (indexer).
管理Slot部署的生命周期——包括Katana(执行层)和Torii(索引器)。

Prerequisites

前置条件

Install the Slot CLI:
sh
curl -L https://slot.cartridge.sh | bash
Authenticate:
sh
slot auth login
For CI/scripts, generate a token and set the
SLOT_AUTH
env var:
sh
slot auth token
安装Slot CLI:
sh
curl -L https://slot.cartridge.sh | bash
身份验证:
sh
slot auth login
对于CI/脚本场景,生成令牌并设置
SLOT_AUTH
环境变量:
sh
slot auth token

Creating Deployments

创建部署

Katana

Katana

sh
slot deployments create <Project Name> katana
sh
slot deployments create <Project Name> katana

Torii

Torii

Torii requires a TOML configuration file:
sh
slot deployments create <Project Name> torii --config <path/to/torii.toml>
Minimal
torii.toml
:
toml
rpc = "https://api.cartridge.gg/x/starknet/mainnet"
world_address = "0x3fa481f41522b90b3684ecfab7650c259a76387fab9c380b7a959e3d4ac69f"
Extended config options:
toml
[indexing]
allowed_origins = ["*"]
index_pending = true
index_transactions = false
polling_interval = 1000
contracts = [
  "erc20:<contract-address>",
  "erc721:<contract-address>"
]

[events]
raw = true
historical = ["namespace-EventName"]
When you create a service with a new project name, a team is automatically created.
Torii需要一个TOML配置文件:
sh
slot deployments create <Project Name> torii --config <path/to/torii.toml>
最小化
torii.toml
配置:
toml
rpc = "https://api.cartridge.gg/x/starknet/mainnet"
world_address = "0x3fa481f41522b90b3684ecfab7650c259a76387fab9c380b7a959e3d4ac69f"
扩展配置选项:
toml
[indexing]
allowed_origins = ["*"]
index_pending = true
index_transactions = false
polling_interval = 1000
contracts = [
  "erc20:<contract-address>",
  "erc721:<contract-address>"
]

[events]
raw = true
historical = ["namespace-EventName"]
当你使用新项目名称创建服务时,会自动创建一个团队。

Updating Deployments

更新部署

sh
slot deployments update <Project Name> torii --version v1.0.0
slot deployments update <Project Name> torii --config <path/to/torii.toml>
slot deployments update <Project Name> torii --replicas 3
sh
slot deployments update <Project Name> torii --version v1.0.0
slot deployments update <Project Name> torii --config <path/to/torii.toml>
slot deployments update <Project Name> torii --replicas 3

Deleting Deployments

删除部署

sh
slot deployments delete <Project Name> <katana | torii>
sh
slot deployments delete <Project Name> <katana | torii>

Inspecting Deployments

查看部署

sh
undefined
sh
undefined

List all deployments

列出所有部署

slot deployments list
slot deployments list

View configuration

查看配置

slot deployments describe <Project Name> <katana | torii>
slot deployments describe <Project Name> <katana | torii>

Read logs

读取日志

slot deployments logs <Project Name> <katana | torii>
slot deployments logs <Project Name> <katana | torii>

View predeployed Katana accounts

查看预部署的Katana账户

slot deployments accounts <Project Name> katana
undefined
slot deployments accounts <Project Name> katana
undefined

Transferring Services

转移服务

Transfer a service to another team:
sh
slot d transfer <Project Name> <katana | torii> <To Team Name>
将服务转移到另一个团队:
sh
slot d transfer <Project Name> <katana | torii> <To Team Name>

Observability

可观测性

Enable Prometheus and Grafana monitoring ($10/month per deployment).
启用Prometheus和Grafana监控(每个部署每月10美元)。

On creation

创建时启用

sh
slot deployments create <Project Name> --observability katana
slot deployments create <Project Name> --observability torii --config <path/to/torii.toml>
sh
slot deployments create <Project Name> --observability katana
slot deployments create <Project Name> --observability torii --config <path/to/torii.toml>

On existing deployment

在现有部署上启用

sh
slot deployments update <Project Name> --observability katana
slot deployments update <Project Name> --observability torii
sh
slot deployments update <Project Name> --observability katana
slot deployments update <Project Name> --observability torii

Accessing dashboards

访问仪表板

  • Prometheus:
    https://<deployment-url>/prometheus
  • Grafana:
    https://<deployment-url>/grafana
Both are protected by username/password credentials provided when observability is enabled.
  • Prometheus:
    https://<deployment-url>/prometheus
  • Grafana:
    https://<deployment-url>/grafana
两者均受启用可观测性时提供的用户名/密码凭证保护。