Meilisearch: Automatizuokite naudodami CLI

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

Sveiki atvykę į Stackhero dokumentaciją!

Jei ieškote galingos ir lengvai naudojamos paieškos sistemos, Stackhero Meilisearch cloud paslauga yra puikus pasirinkimas. Štai ko galite tikėtis:

Individualus domeno vardas su integruotu HTTPS saugumu.

Atnaujinimai be rūpesčių – tereikia vieno paspaudimo.

Aukšta sparta ir stipri apsauga dėl Jūsų privačios ir dedikuotos VM.

Norite pradėti greitai? Išbandykite Stackhero Meilisearch cloud hosting sprendimą vos per 5 minutes. Jis sukurtas tam, kad sutaupytumėte laiko ir kuo labiau supaprastintumėte diegimą!

Šiame vadove parodoma, kaip sukurti Meilisearch 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 Meilisearch paslaugos parduotuvę (service store)

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

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

Vėlesnėse komandose galite naudoti parduotuvės pavadinimą meilisearch, 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=meilisearch

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

4. Sukurkite paslaugą

Žemiau pateiktas pavyzdinis scenarijus sukuria stack, prideda jūsų Meilisearch 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="meilisearch"   # Meilisearch 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 Meilisearch stack")
echo "Stack sukurtas: ${stackId}"

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

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

# Gaukite paslaugos konfigūraciją, įskaitant sugeneruotus prisijungimo duomenis
stackhero service-configuration-get --service="meilisearch" --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.