콘텐츠로 이동
Tier0 Docs

Agent로 Tier0 운영

지원 에디션EdgeCloudEnterprise

Tier0는 agent가 Tier0를 운영할 수 있도록 skill과 CLI command를 제공합니다.

Tier0 Skills 설치

섹션 제목: “Tier0 Skills 설치”

필요한 CLI version: v0.4.6+

환경에 맞는 installer를 선택하세요.

Node.js가 있는 경우

섹션 제목: “Node.js가 있는 경우”

Node.js 16 이상을 사용할 수 있으면 npx로 CLI와 skills를 설치합니다.

Terminal window
npx @tier0/cli@latest

이 command는 전체 installer를 실행하며 두 가지 작업을 수행합니다.

  • tier0 CLI binary를 ~/.tier0/bin/에 설치합니다.
  • FREEZONEX/Tier0-skill에서 Cursor/Claude Agent Skills를 설치합니다.

Node.js가 없는 경우

섹션 제목: “Node.js가 없는 경우”
  1. tier0 CLI binary를 설치합니다.
Terminal window
curl -fsSL https://raw.githubusercontent.com/FREEZONEX/Tier0-cli/main/install.sh | bash
  1. Agent Skills를 설치합니다.
Terminal window
tier0 skills update

Tier0 Skill로 할 수 있는 일

섹션 제목: “Tier0 Skill로 할 수 있는 일”

Tier0 Skills는 agent가 적절한 CLI command를 선택하고, 관련 reference를 읽고, tier0 CLI를 통해 Tier0를 운영할 수 있는 구조화된 방법을 제공합니다.

운영 대상 instance 설정

섹션 제목: “운영 대상 instance 설정”

Private deployment에서는 login 전에 base URL을 설정해야 합니다. 설정 후 아래 모든 command는 해당 instance에서 실행됩니다.

Terminal window
tier0 config --base-url https://your-tier0.example.com

로그인

섹션 제목: “로그인”

  1. 운영 대상 instance에 API key를 설정합니다.

    Terminal window
    tier0 config --api-key <api-key>

  2. API key identity와 permission을 검증합니다.

    Terminal window
    tier0 auth whoami

  3. tier0 CLI로 다른 작업을 수행합니다.
대상 작업 명령어
기본 작업 CLI와 service health 확인 tier0 doctor
기본 작업 service connectivity와 gateway info 확인 tier0 api /openapi/v1/info --body '{}' --json
기본 작업 CLI와 skills upgrade tier0 upgrade 및 tier0 skills update
UNS path 탐색 tier0 uns browse --path / 또는 tier0 uns browse --path Plant/Line1 --json
UNS keyword로 topic 검색 tier0 uns search --keyword temp --json 또는 tier0 uns search --path-prefix Plant/Line1 --size 50 --json
UNS 현재 value 읽기 tier0 uns read Plant/Line1/Metric/Temperature --json 또는 tier0 uns read --topic 'Plant/+/Metric/Temperature' --json
UNS value 쓰기 tier0 uns write --topic Plant/Line1/Metric/Temperature --value '{"temperature":27.5}'
UNS history 조회 tier0 uns history -t Plant/Line1/Metric/Temperature --start -1h --json
UNS path 또는 topic 생성 tier0 uns create --topic Plant/Line1 --type path 또는 tier0 uns create --file namespace.json --json
UNS metadata 또는 field update tier0 uns update --path Plant/Line1/Metric/Temperature --description "Line 1 temperature" --update-mask description
UNS node 삭제 또는 복원 tier0 uns delete --path Plant/Line1/Metric/Temperature --yes 또는 tier0 uns restore --path Plant/Line1/Metric/Temperature --yes
Node-RED Flow Flow list 또는 inspect tier0 flow list, tier0 flow list --source --json, 또는 tier0 flow get --id 1 --json
Node-RED Flow Source Flow 또는 Event Flow 생성 tier0 flow create --name "modbus-collector" --source --desc "Modbus TCP collector" 또는 tier0 flow create --name "alert-handler" --event --desc "Temperature alarm processor"
Node-RED Flow Flow metadata update tier0 flow update --id 1 --name "line1-collector" 또는 tier0 flow update --id 1 --favorite
Node-RED Flow canvas JSON export tier0 flow data --id 1 --out flows.json
Node-RED Flow canvas JSON deploy tier0 flow deploy --id 1 -f flows.json --yes
Node-RED Flow Flow 삭제 tier0 flow delete --id 1 --yes
Node-RED Flow 사용 가능한 node type 확인 tier0 flow nodes --source --json 또는 tier0 flow nodes --event --json

Tier0 Skills 제거

섹션 제목: “Tier0 Skills 제거”
Terminal window
# local configuration은 유지하고 Tier0 CLI만 제거합니다.
npx @tier0/cli@latest uninstall


# Tier0 CLI와 local configuration, credentials, skills, cache를 모두 제거합니다.
npx @tier0/cli@latest uninstall --purge

Skill 참조

섹션 제목: “Skill 참조”

Tier0 Skill 참조에는 지원되는 operation target, common task, 해당 CLI command가 정리되어 있습니다.

다음 단계

섹션 제목: “다음 단계”