Przejdź do treści
Biblioteka skilli
DevOps i chmura · Automatyzacja

ark-setup-cluster

/ark-setup-cluster

Instaluje platformę Ark w klastrze Kubernetes w trybie domyślnym albo izolowanym do testów e2e na dedykowanym klastrze Kind.

Licencja
Apache-2.0
Ostatnia zmiana repozytorium
23.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 23.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Instaluje platformę Ark w klastrze Kubernetes w trybie domyślnym albo izolowanym do testów e2e na dedykowanym klastrze Kind.

Oryginalny opis (EN)

Set up and install the Ark platform in a Kubernetes cluster. Supports default mode (existing cluster) and isolated e2e testing mode (dedicated Kind cluster). Use when the user wants to install, deploy, test, or configure Ark.

Jak działa

  1. When to use this skill
  2. Prerequisites
  3. Step 0: Check existing cluster state
  4. Step 1: Create cluster
  5. Step 2: Build ark-cli from source
  6. Step 3: Install Ark
  7. Step 4: Verify installation
  8. Step 5: Cleanup (e2e testing mode)
  9. Troubleshooting
  10. Important
Sekcje z nagłówków SKILL.md, w oryginale · 142 linii, 574 słów
Podgląd SKILL.md
---
name: ark-setup-cluster
description: Set up and install the Ark platform in a Kubernetes cluster. Supports default mode (existing cluster) and isolated e2e testing mode (dedicated Kind cluster). Use when the user wants to install, deploy, test, or configure Ark.
---

# Ark Setup Cluster

Set up and install the Ark platform using ark-cli. Supports two modes:

- **Default**: Deploy Ark to an existing cluster
- **Isolated e2e**: Create a dedicated Kind cluster for testing without affecting existing clusters

## When to use this skill

- User wants to install or set up Ark
- Build manager needs an isolated cluster for e2e testing
- User needs to deploy Ark to their local cluster
- User needs to troubleshoot Ark installation issues

## Prerequisites

1. **Docker** - Required for Kind cluster creation
2. **kubectl** - Kubernetes CLI
3. **Helm** - For installing Ark components
4. **Node.js** - For building the ark-cli tool
5. **Kind** - For creating local clusters (`which kind`)

## Step 0: Check existing cluster state

**CRITICAL: Always check before creating or modifying clusters.**

```bash
kubectl cluster-info 2>/dev/null
kubectl get pods -n default 2>/dev/null | head -10
kind get clusters 2>/dev/null
```

### If a cluster is already running

**Never silently destroy an existing cluster.** It may have user data, demos, or in-progress work. Present options:

- **Option A: Reuse existing cluster** — deploy Ark into it. Fastest, but overwrites current Ark state.
- **Option B: Create isolated cluster** (recommended for e2e testing) — `kind create cluster --name ark-e2e-test`. Fully isolated, preserves existing cluster.
- **Option C: Replace existing cluster** — delete and recreate. Only if user explicitly confirms.

Wait for user to choose, or if called by the build manager for e2e testing, default to Option B.

## Step 1: Create cluster

### Default mode (existing cluster or new ark-cluster)

```bash
kind create cluster --name ark-cluster
```

### Isolated e2e testing mode

```bash
kind create cluster --name ark-e2e-test
kubectl config use-context kind-ark-e2e-test
```

### Configure kubeconfig (if running inside Docker/DinD)

```bash
CONTROL_PLANE_IP=$(docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <cluster-name>-control-plane)
kind get kubeconfig --name <cluster-name> --internal | sed "s/<cluster-name>-control-plane/$CONTROL_PLANE_IP/g" > ~/.kube/config
kubectl cluster-info
```

On Mac with Docker Desktop, the default kubeconfig works without IP replacement.

## Step 2: Build ark-cli from source

```bash
cd agents-at-scale-ark
npm install
cd tools/ark-cli
npm install
npm run build
```

## Step 3: Install Ark

```bash
node tools/ark-cli/dist/index.js install --yes --wait-for-ready 5m
```

If specific chart versions aren't published yet (e.g., on a feature branch), install components individually:

```bash
helm install ark-controller oci://mckinsey-ark-helm.jfrog.io/ark-helm/ark-controller --version <version>
# ark-broker must precede ark-tenant: the tenant chart refuses a fresh install
# into a namespace with no broker Service.
helm install ark-broker oci://mckinsey-ark-helm.jfrog.io/ark-helm/ark-broker --version <version>
helm install ark-tenant oci://mckinsey-ark-helm.jfrog.io/ark-helm/ark-tenant --version <version>
helm install ark-api oci://mckinsey-ark-helm.jfrog.io/ark-helm/ark-api --version <version>
helm install ark-dashboard oci://mckinsey-ark-helm.jfrog.io/ark-helm/ark-dashboard --version <version>
```

## Step 4: Verify installation

```bash
kubectl get pods -n default
kubectl get services -n default
```

Wait until all pods show **Running** and **Ready**.

## Step 5: Cleanup (e2e testing mode)

After testing is complete:

```bash
kind delete cluster --name ark-e2e-test
```

Restore original kubectl context if needed:

```bash
kubectl config use-context <original-context>
```

## Troubleshooting

### Docker not available
If `docker info` fails, Kind cannot create clusters. Report to user.

### Check pod status
```bash
kubectl get pods -A -o wide | grep -E '(ark|cert-manager)'
kubectl describe pod <pod-name>
```

### View logs
```bash
kubectl logs deployment/ark-api
kubectl logs -n ark-system deployment/ark-controller
```

## Important

- **DO NOT use `scripts/quickstart.sh`** — deprecated. Use ark-cli.
- **DO NOT use `npm install -g @agents-at-scale/ark`** — build from source to match the branch being tested.
- **CI uses K3s** (Linux-only). Local Mac testing uses Kind. Generally compatible but minor differences possible.

Wersje

W bazie nie ma innych skilli o nazwie ark-setup-cluster.

Migawka bazy z 13.11.2026 · wersja paczki 6ce201c797e5 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90Ark Analysis
    Analizuje bazę kodu Ark przez sklonowanie repozytorium do tymczasowej lokalizacji, odpowiadając na pytania o działanie i implementację Ark.
  • 90Ark Dashboard and UI Testing
    Testuje dashboard i UI Ark za pomocą Playwright oraz tworzy pull requesty ze zrzutami ekranu.
  • 100eaiapps-guided-install
    Prowadzi przez instalację AI Workbench na klastrze Kubernetes: sprawdza gotowość, instaluje wykresy Helm i weryfikuje, czy wdrożenie działa.
  • 95glab-cluster
    Podłącza klastry Kubernetes do GitLab i zarządza agentami klastra oraz integracją Kubernetes.
  • 100deploy-llm-d
    Konfiguruje i wdraża stos llm-d na istniejącym klastrze Kubernetes lub OpenShift według przewodników Well-Lit Path, weryfikuje go i dostosowuje.
  • 95ark-console
    Buduje lokalną konsolę do generowania wideo i obrazów przez API Volcano Ark, z CLI, stroną w jednym pliku i bez zależności.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.