Grafana: Automatyzacja z CLI

Uruchom Grafana, pobierz jego dane dostępowe i zmień konfigurację programowo za pomocą Stackhero CLI

👋 Witamy w dokumentacji Stackhero!

Stackhero zapewnia gotowe do użycia środowisko Grafana cloud, zaprojektowane do szybkiego uruchomienia i niezawodnej pracy:

Nielimitowana liczba użytkowników, dashboardów i alertów: skaluj monitoring według potrzeb, bez sztucznych ograniczeń.

Dedykowany serwer SMTP email w zestawie, dzięki czemu możesz wysyłać dowolną liczbę powiadomień, bez konieczności kontrolowania limitów.

Instalacja pluginów jednym kliknięciem ułatwia dodawanie nowych funkcji do Grafana.

Wbudowana obsługa SSO dla GitLab, GitHub, Google oraz dowolnego ogólnego dostawcy OAuth2. Zarządzanie użytkownikami pozostaje proste i bezpieczne.

Aktualizacje jednym kliknięciem pozwalają utrzymać Twoją instancję Grafana zawsze aktualną, bez przestojów i problemów z utrzymaniem.

Użyj własnej domeny niestandardowej z automatycznym wdrożeniem HTTPS dla bezpiecznego i spersonalizowanego dostępu (np. https://grafana.twoja-firma.com).

Wysoka wydajność i silne zabezpieczenia są standardem, działając na Twojej prywatnej, dedykowanej infrastrukturze.

Rozpocznij szybciej i oszczędź czas na konfiguracji: bezpieczna instancja Grafana cloud hosting jest gotowa w około 5 minut.

Ten przewodnik pokazuje, jak utworzyć usługę Grafana, odczytać jej dane dostępowe oraz zaktualizować konfigurację całkowicie z poziomu wiersza poleceń, bez konieczności klikania w panelu zarządzania. To idealne rozwiązanie dla skryptów, pipeline’ów CI oraz agentów AI.

Do wszystkich zadań będziemy używać Stackhero CLI. Jeśli jeszcze nie masz zainstalowanego narzędzia, możesz to zrobić poleceniem:

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

1. Uwierzytelnianie

Najprostszym sposobem rozpoczęcia pracy jest zalogowanie się przez przeglądarkę. Po uruchomieniu polecenia logowania CLI otworzy stronę internetową, na której możesz zatwierdzić dostęp. Żadne hasła ani kody 2FA nie są wprowadzane bezpośrednio w CLI.

stackhero login

Po zalogowaniu Twoje dane dostępowe zostaną zapisane lokalnie i będą automatycznie wykorzystywane przez kolejne polecenia CLI.

W środowiskach w pełni zautomatyzowanych, takich jak skrypty czy pipeline’y CI, możesz preferować nieinteraktywny token dostępu. Możesz go utworzyć w panelu (Konto > Access tokens), a następnie wyeksportować jako zmienną środowiskową. CLI oraz każdy uruchamiany skrypt automatycznie go wykryje.

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

2. Znajdź sklep usług Grafana

Następnie warto wyświetlić listę sklepów usług Grafana dostępnych na Twoim koncie. CLI akceptuje bezpośrednio nazwę sklepu (grafana), więc nie musisz wyszukiwać ani kopiować żadnych identyfikatorów.

# Wyświetl sklepy usług Grafana (dodaj --organization, jeśli zarządzasz więcej niż jedną)
stackhero services-store-list --name="grafana"

Nazwy sklepów grafana możesz używać w kolejnych poleceniach lub, jeśli wolisz, wybrać konkretny identyfikator svs-xxxxxx z listy.

3. Wybierz rozmiar instancji i region

# Wyświetl dostępne rozmiary instancji dla wybranego sklepu usług (użyj kolumny NAME dla --instance)
stackhero instances-store-list --service-store=grafana

# Wyświetl dostępne regiony (nazwy takie jak "europe")
stackhero regions-list

4. Utwórz usługę

Poniżej znajduje się przykładowy skrypt, który tworzy stack, dodaje do niego usługę Grafana, czeka na jej uruchomienie, pobiera konfigurację (wraz z wygenerowanymi danymi dostępowymi), a następnie stosuje nową konfigurację.

#!/bin/bash
set -e

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

serviceStore="grafana"   # Nazwa sklepu usług Grafana (patrz krok 2)
instance="..."                # Rozmiar instancji z kroku 3
region="europe"               # Nazwa regionu z kroku 3

# Utwórz stack dla swojej usługi (domyślnie używa Twojej organizacji; dodaj --organization, jeśli potrzeba)
stackId=$(stackhero --format=script stack-create \
  --name="My Grafana stack")
echo "Stack utworzony: ${stackId}"

# Dodaj Grafana do stacka (nazwy są rozpoznawane automatycznie)
serviceId=$(stackhero --format=script service-add \
  --stack="My Grafana stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Usługa dodana: grafana"

# Poczekaj, aż usługa będzie w pełni uruchomiona (może to potrwać kilka minut)
stackhero service-wait-for --service="grafana"

# Pobierz konfigurację usługi, w tym wygenerowane dane dostępowe
stackhero service-configuration-get --service="grafana" --format=json

5. Pobierz dane dostępowe

Polecenie service-configuration-get zwraca pełną konfigurację Twojej usługi, w tym automatycznie wygenerowane hasła i szczegóły połączenia. Wynik jest w formacie JSON, co ułatwia wykorzystanie w skryptach i automatyzacji.

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

6. Zmień konfigurację

Możesz przejrzeć przykładowy schemat konfiguracji, a następnie zastosować własne ustawienia. Po aktualizacji konfiguracji usługa może zostać zrestartowana, aby zastosować zmiany.

# Wyświetl schemat konfiguracji i przykład dla swojej usługi
stackhero service-configuration-example --service=svc-xxxxxx

# Zastosuj własną konfigurację (usługa zostanie zrestartowana, jeśli to konieczne)
stackhero service-configuration-set \
  --service=svc-xxxxxx \
  --configuration='{ "...": "..." }'

# Poczekaj na zastosowanie nowej konfiguracji
stackhero service-wait-for --service=svc-xxxxxx

To wszystko. Poznałeś pełny cykl życia: uruchomienie usługi, pobranie jej danych dostępowych oraz rekonfigurację – wszystko w sposób skryptowalny i zautomatyzowany. Aby dowiedzieć się więcej, zapoznaj się z pełną dokumentacją CLI, która obejmuje również nieinteraktywną autoryzację STACKHERO_TOKEN pokazaną w tym przewodniku.