コンテンツにスキップ
greentic.ai Greentic Docs

インストール

システム要件

Section titled “システム要件”

最小要件

Section titled “最小要件”
Component要件
OSLinux, macOS, Windows
Rust1.95+
Memory4 GB RAM
Disk2 GB の空き容量

推奨

Section titled “推奨”
Component要件
Rust1.95+ (latest supported)
Memory8 GB RAM
CPUマルチコア processor

Rust のインストール

Section titled “Rust のインストール”

Rust がインストールされていない場合:

Terminal window
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

正しい toolchain version を設定します:

Terminal window
rustup default 1.95

component を build するための WASM target を追加します:

Terminal window
rustup target add wasm32-wasip2

GTC CLI のインストール

Section titled “GTC CLI のインストール”

まず gtc router をインストールし、その後 gtc install で Greentic companion tools をインストールします。通常利用では greentic-cli や個別の companion crates を直接インストールしないでください。gtc install が delegated binaries を router と揃えます。

Terminal window
cargo install cargo-binstall
cargo binstall gtc
gtc install
gtc doctor

インストールの確認

Section titled “インストールの確認”
Terminal window
gtc --version
gtc doctor

オプション依存関係

Section titled “オプション依存関係”

Redis (Session Storage)

Section titled “Redis (Session Storage)”

production の session persistence 向け:

Terminal window
docker run -d --name redis -p 6379:6379 redis:alpine

Ngrok/Cloudflared (Public URLs)

Section titled “Ngrok/Cloudflared (Public URLs)”

webhook ベースの provider (Telegram、Slack など) 向け:

Terminal window
# Install
brew install ngrok/ngrok/ngrok  # macOS
# or download from https://ngrok.com/download


# Configure
ngrok config add-authtoken YOUR_TOKEN


# Run
ngrok http 8080

Development Tools

Section titled “Development Tools”

Greentic Toolchain

Section titled “Greentic Toolchain”

gtc router が使う delegated Greentic binaries をインストールまたは更新します:

Terminal window
gtc install

Install plan を確認するには gtc install --dry-run を使います。Controlled environments では toolchain を pin できます:

Terminal window
gtc install --release 1.0.15
gtc install --manifest ./greentic-toolchain.json

Component Authoring

Section titled “Component Authoring”

gtc install は standard companion tools をインストールします。Standalone component development では cargo-component も利用できます:

Terminal window
cargo binstall cargo-component

その後、delegated component surface を使います:

Terminal window
gtc dev component --help

セットアップの検証

Section titled “セットアップの検証”

すべてが正しく動作していることを確認するには、次を実行します:

Terminal window
# Check GTC CLI
gtc --help


# Check Rust WASM target
rustup target list --installed | grep wasm32-wasip2


# Create and run a test bundle
gtc wizard --dry-run

トラブルシューティング

Section titled “トラブルシューティング”

よくある問題

Section titled “よくある問題”

Error: “wasm32-wasip2 target not found”

Terminal window
rustup target add wasm32-wasip2

Error: “Permission denied”

Terminal window
# On Linux/macOS, ensure binary is executable
chmod +x /usr/local/bin/gtc

次のステップ

Section titled “次のステップ”