Code-Hero: Automatizuokite naudodami CLI

Paleiskite Code-Hero, gaukite jo prisijungimo duomenis ir keiskite jo konfigūraciją programiškai su Stackhero CLI

👋 Sveiki atvykę į Stackhero dokumentaciją!

Stackhero siūlo Code-Hero, išsamią kūrimo platformą, leidžiančią koduoti per kelias sekundes:

• Koduokite iš bet kur: Naudokite bet kurį įrenginį, nesvarbu, ar tai būtų stacionarus kompiuteris, telefonas ar planšetė, nereikalaujant jokios programinės įrangos diegimo.
• Integruota VSCode patirtis: Dirbkite su pritaikyta VSCode versija tiesiogiai per savo naršyklę, turinčia visiškai funkcionalų terminalą.
• Išsamus įrankių rinkinys: Pasinaudokite iš anksto sukonfigūruota aplinka su tokiais įrankiais ir kalbomis kaip Docker, Git, Zsh, Node.js, Go, Python, Ruby ir kt.
• Sklandi jungtis: Pasiekite savo kūrimo programas per HTTPS viešame domene, imituojant gamybos sąlygas. Ši konfigūracija palaiko webhooks ir išorines integracijas be jokių pastangų.

Patirkite Stackhero Code-Hero kūrimo debesies sprendimo efektyvumą ir patogumą. Pradėti užtrunka tik 5 minutes! Supaprastinkite savo kūrimo procesus ir sutaupykite vertingo laiko jau šiandien.

Šiame vadove parodoma, kaip sukurti Code-Hero paslaugą, perskaityti jos prisijungimo duomenis ir atnaujinti jos konfigūraciją visiškai iš komandinės eilutės, be jokių paspaudimų valdymo skydelyje. Tai idealiai tinka scenarijams (scripts), CI procesams ir AI agentams.

Visoms užduotims naudosime Stackhero CLI. Jei dar neįdiegėte, galite tai padaryti taip:

curl -fsSL https://www.stackhero.io/install.sh | sh

1. Autentifikacija

Lengviausias būdas pradėti – prisijungti per naršyklę. Paleidus prisijungimo komandą, CLI atidarys tinklalapį, kuriame galėsite patvirtinti prieigą. Jokių slaptažodžių ar 2FA kodų CLI įvesti nereikės.

stackhero login

Prisijungus, jūsų prisijungimo duomenys bus saugomi lokaliai ir automatiškai naudojami visoms būsimoms CLI komandoms.

Pilnai automatizuotoms aplinkoms, tokioms kaip scenarijai ar CI procesai, galite rinktis neinteraktyvų prieigos raktą (access token). Jį galite sukurti savo valdymo skydelyje (Account > Access tokens), tada eksportuoti kaip aplinkos kintamąjį. CLI ir visi jūsų paleisti scenarijai jį automatiškai aptiks.

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

2. Raskite Code-Hero paslaugos parduotuvę (service store)

Toliau norėsite išvardyti savo paskyroje prieinamas Code-Hero paslaugų parduotuves. CLI priima parduotuvės pavadinimą (code-hero) tiesiogiai, todėl nereikia ieškoti ar kopijuoti jokių ID.

# Išvardinkite Code-Hero paslaugų parduotuves (pridėkite --organization, jei valdote daugiau nei vieną)
stackhero services-store-list --name="code-hero"

Vėlesnėse komandose galite naudoti parduotuvės pavadinimą code-hero, arba, jei pageidaujate, pasirinkti konkretų svs-xxxxxx ID iš sąrašo.

3. Pasirinkite instancijos dydį ir regioną

# Išvardinkite instancijų dydžius savo paslaugų parduotuvei (naudokite NAME stulpelį --instance parametrui)
stackhero instances-store-list --service-store=code-hero

# Išvardinkite galimus regionus (pvz., "europe")
stackhero regions-list

4. Sukurkite paslaugą

Žemiau pateiktas pavyzdinis scenarijus sukuria stack, prideda jūsų Code-Hero paslaugą, laukia jos paleidimo, gauna jos konfigūraciją (įskaitant sugeneruotus prisijungimo duomenis) ir tada pritaiko naują konfigūraciją.

#!/bin/bash
set -e

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

serviceStore="code-hero"   # Code-Hero paslaugos parduotuvės pavadinimas (žr. 2 žingsnį)
instance="..."                # Instancijos dydis iš 3 žingsnio
region="europe"               # Regiono pavadinimas iš 3 žingsnio

# Sukurkite stack savo paslaugai (naudoja numatytąją organizaciją; jei reikia, pridėkite --organization)
stackId=$(stackhero --format=script stack-create \
  --name="My Code-Hero stack")
echo "Stack sukurtas: ${stackId}"

# Pridėkite Code-Hero prie stack (pavadinimai atpažįstami automatiškai)
serviceId=$(stackhero --format=script service-add \
  --stack="My Code-Hero stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Paslauga pridėta: code-hero"

# Palaukite, kol paslauga bus pilnai paleista (tai gali užtrukti kelias minutes)
stackhero service-wait-for --service="code-hero"

# Gaukite paslaugos konfigūraciją, įskaitant sugeneruotus prisijungimo duomenis
stackhero service-configuration-get --service="code-hero" --format=json

5. Gaukite prisijungimo duomenis

Komanda service-configuration-get grąžina visą jūsų paslaugos konfigūraciją, įskaitant automatiškai sugeneruotus slaptažodžius ir prisijungimo informaciją. Rezultatas pateikiamas JSON formatu, todėl jį lengva naudoti scenarijuose ir automatizacijoje.

stackhero service-configuration-get --service=svc-xxxxxx --format=json

6. Keiskite konfigūraciją

Galite peržiūrėti pavyzdinę konfigūracijos schemą ir tada pritaikyti savo nustatymus. Atnaujinus konfigūraciją, paslauga gali būti paleista iš naujo, kad pakeitimai įsigaliotų.

# Peržiūrėkite konfigūracijos schemą ir pavyzdį savo paslaugai
stackhero service-configuration-example --service=svc-xxxxxx

# Pritaikykite individualią konfigūraciją (paslauga bus paleista iš naujo, jei reikės)
stackhero service-configuration-set \
  --service=svc-xxxxxx \
  --configuration='{ "...": "..." }'

# Palaukite, kol nauja konfigūracija bus pritaikyta
stackhero service-wait-for --service=svc-xxxxxx

Viskas. Dabar matėte visą ciklą: paleiskite paslaugą, gaukite jos prisijungimo duomenis ir perkonfigūruokite ją – visa tai galima automatizuoti ir naudoti scenarijuose. Norėdami sužinoti daugiau, peržiūrėkite pilną CLI dokumentaciją, kurioje taip pat aprašyta neinteraktyvi STACKHERO_TOKEN autentifikacija, parodyta šiame vadove.