Konradodocs
PołączeniaIntegracjeIntegracje serweroweWirtualizacja

SolusVM 2

Konrado sprawdza VPS, którego dotyczy zgłoszenie, przez API SolusVM 2 albo wtyczkę Konrado.

SolusVM 2
Wirtualizacja
VPS, którego dotyczy każde zgłoszenie

Po podłączeniu SolusVM 2 Konrado sprawdza VPS, którego dotyczy zgłoszenie. Widzi jego stan, plan, dyski, snapshoty, kopie zapasowe i ostatnie zadania. Konrado tylko czyta. W Twoim panelu nic się nie zmienia.

Możesz podłączyć panel na dwa sposoby. Przez API Konrado czyta panel SolusVM 2 za pomocą tokenu API i nic nie trzeba instalować. Przy Wtyczka Konrado uruchamiasz jedno polecenie jako root na serwerze SolusVM 2. API to obecny sposób. Wtyczka to starsza metoda: działa dalej tam, gdzie jest zainstalowana, ale nowy serwer podłącz przez API. Wybierz zakładkę poniżej. Każda sekcja pokaże wtedy Twój wybór.

API
Nic do instalowania
Token API SolusVM 2.
Wtyczka Konrado
Starsza metoda
Jedno polecenie jako root na serwerze SolusVM 2.
Dostęp
Tylko odczyt
Konrado nigdy nie uruchamia, nie zatrzymuje ani nie zmienia VPS.
Agenci dostają
Sprawdzanie kont
Dla VPS z każdego zgłoszenia.

Co czyta Konrado

Konrado znajduje VPS na podstawie usługi klienta w Twoim systemie rozliczeniowym. Czyta tylko maszyny wirtualne (VM) należące do tej usługi.

DaneDo czego się przydają
VPSStan zasilania, plan, limity CPU, RAM i dysku, adresy IP, system operacyjny i zasób obliczeniowy, na którym działa
DyskiIle dysków ma VPS i jak duży jest każdy z nich
Kopie zapasoweKopie zapasowe VPS: jakie istnieją, kiedy powstała każda z nich i jaki ma rozmiar
SnapshotySnapshoty VPS, z takimi samymi datami i rozmiarami
ZadaniaOstatnie zadania, np. restarty, reinstalacje, kopie zapasowe i migracje, ze stanem i czasem

Listy kończą się na 50 dyskach oraz na 100 kopiach zapasowych, snapshotach lub zadaniach. Lista zadań podaje łączną liczbę z panelu i informuje, kiedy się urywa.

DaneDo czego się przydają
VPS i parametryID VM, stan, plan, zasób obliczeniowy, adresy IP i zasoby
Kopie zapasoweKopie zapasowe VPS ze zgłoszenia
SnapshotySnapshoty VPS, zanim przekażesz dalej przywracanie lub wycofanie zmian
DyskiUstawienia i rozmiary dysków
Historia zadańOstatnie zadania, np. nieudane uruchomienie usługi, kopia zapasowa lub inna operacja

Czego Konrado nie potrafi

Nie da sięDlaczego
Uruchomić, zatrzymać, zrestartować, zresetować ani włączyć trybu ratunkowego VPSKonrado czyta. Działania na zasilaniu zostają przy Twoim zespole
Utworzyć, usunąć, przywrócić, pobrać ani zaplanować kopii zapasowej lub snapshotuOdzyskiwanie danych zostaje przy Twoim zespole
Odbudować, przeinstalować, zmienić rozmiar, przenieść ani zmienić CPU, RAM, dysku lub adresów IPZmiany zostają w Twoim systemie zakładania usług
Odczytać VPS spoza usługi ze zgłoszeniaKonrado odrzuca każde inne ID VM, zanim połączy się z panelem
Wyświetlić cały panel ani działać na wielu VM narazKonrado zajmuje się VPS ze zgłoszenia
Zarządzać użytkownikami, rolami, planami, lokalizacjami, zasobami obliczeniowymi ani pulami IPKonrado używa stałych sprawdzeń, a nie administracji panelem
Znaleźć VPS bez ID VM w usłudzeKażde sprawdzenie wymaga ID VM zapisanego w Twoim systemie rozliczeniowym
Model bezpieczeństwa

Konrado łączy się z SolusVM 2 przez HTTPS za pomocą jednego tokenu API, który możesz w każdej chwili usunąć. Nigdy nie wpisuj w Konrado hasła administratora. Po zapisaniu tokenu konsola pokazuje tylko jego ostatnie znaki.

  • Działają tylko adresy https://. Certyfikat TLS musi być ważny. Konrado zgłasza problem z certyfikatem i nigdy nie pomija tego sprawdzenia.
  • Adres musi prowadzić do publicznego adresu IP. Konrado odrzuca adresy prywatne, adresy pętli zwrotnej (loopback) i inne zakresy wewnętrzne.
  • Konrado ogranicza rozmiar każdej odpowiedzi i najpierw usuwa z niej dane poufne.
  • Sprawdzenia są powiązane z VM usługi ze zgłoszenia. Konrado nie może wysyłać zapytań do panelu bezpośrednio.

Token ma uprawnienia użytkownika, do którego należy. Wygeneruj go dla użytkownika z rolą tylko do odczytu, chyba że Twój regulamin dla panelu wymaga czegoś innego.

Model bezpieczeństwa

Polecenie instalacji zawiera klucz, który łączy serwer z Twoją organizacją. Traktuj go jak hasło. Konrado łączy się potem z wtyczką na domyślnym porcie 8000. Otwórz ten port dla adresów IP Konrado i dla nikogo więcej.

Przykładowe pytania w zgłoszeniach
  • "Klient pisze, że jego VPS nie działa. Jaki ma stan, adresy IP i plan?"
  • "Klient prosi o przywrócenie danych. Jakie kopie zapasowe są dla tego VPS?"
  • "Zanim przekażemy dalej wycofanie zmian: czy ta VM ma snapshoty?"
  • "Na VPS chyba brakuje miejsca. Jakie ma dyski?"
  • "Klient twierdzi, że zasoby się nie zgadzają. Czy CPU, RAM i dysk pasują do planu?"
  • "Restart albo reinstalacja się nie udały. Co mówi historia zadań?"

Zanim zaczniesz

  • SolusVM 2 pod publicznym adresem HTTPS z ważnym certyfikatem. Konrado czyta jego API /api/v1 na porcie 443, chyba że podasz inny. Konrado przetestowano w pełni na SolusVM 2 w wersji 2.0.0-39984. SolusVM 1 nie ma takiego API i nie działa.
  • Konto, które może tworzyć tokeny API w panelu administracyjnym SolusVM 2.
  • Jeśli panel stoi za firewallem lub WAF, wpuść adresy IP Konrado.
  • Podłączony system rozliczeniowy, w którym każda usługa VPS jest na tym panelu i ma zapisane ID VM z SolusVM. Bez VM do sprawdzenia połączenie działa, ale nic nie wnosi do odpowiedzi. Obsługiwane są moduły WHMCS solusvm2vps i solusvm2vpscloud.
  • Dostęp SSH jako root do serwera SolusVM 2, z curl, unzip i systemd.
  • Token API SolusVM 2, utworzony jak w zakładce API. Instalator o niego zapyta.
  • Dostęp serwera do internetu. Instalator pobiera wtyczkę i zgłasza się do app.konrado.ai.
  • Port 8000 otwarty dla adresów IP Konrado (zobacz listę).
  • Podłączony system rozliczeniowy, w którym każda usługa VPS ma zapisane ID VM z SolusVM.

Podłączanie

Utwórz token API

Zaloguj się do panelu administracyjnego SolusVM 2 na konto, którego ma używać Konrado. Otwórz Access › API Tokens i kliknij Generate API Token.

Panel administracyjny SolusVM 2 z listą API Tokens w sekcji Access

Wpisz nazwę, np. Konrado, sprawdź, do którego użytkownika należy token, i kliknij Generate.

Okno Generate API Token w SolusVM 2 z nazwą, użytkownikiem i przyciskiem Generate

Skopiuj token

SolusVM 2 pokazuje token tylko raz. Kliknij Copy & Close i zapisz token w menedżerze haseł. Jeśli go zgubisz, usuń token i wygeneruj nowy.

Okno SolusVM 2 z nowym tokenem i ostrzeżeniem, że jest widoczny tylko raz

Podłącz w Konrado

Otwórz Ustawienia obszaru roboczegoIntegracje, kliknij Dodaj integrację i wybierz SolusVM 2. W sekcji Jak Konrado ma łączyć się z tym serwerem? opcja Token API jest już wybrana.

Okno SolusVM 2: opcja Token API wybrana zamiast Wtyczka Konrado, a pod nią pola Nazwa integracji, Adres SolusVM 2 i Token API
PoleCo wpisać
Nazwa integracjiNazwa dla Twojego zespołu, np. SolusVM EU
Adres SolusVM 2Adres panelu, np. https://panel.example.com, bez /admin. Jeśli nie podasz portu, używany jest 443
Token APIToken z SolusVM 2

Kliknij Testuj połączenie. Zielone pole potwierdza, że token może czytać panel. SolusVM 2 nie podaje tu wersji, więc żadna się nie pojawia. Kliknij Podłącz.

Wtyczka to starsza metoda podłączania. Serwery już nią podłączone działają dalej. Dla nowego serwera wybierz zakładkę API.

Wybierz wtyczkę. Otwórz Ustawienia obszaru roboczegoIntegracje, kliknij Dodaj integrację i wybierz SolusVM 2. W pytaniu Jak Konrado ma łączyć się z tym serwerem? wybierz Wtyczka Konrado. Okno pokazuje trzy kroki i polecenie instalacji.

Uruchom polecenie jako root. Zaloguj się na serwer SolusVM 2 przez SSH jako root. Kliknij przycisk kopiowania obok polecenia i wklej je w sesji. Okno ukrywa Twój klucz na ekranie, ale skopiowane polecenie go zawiera, więc traktuj je jak hasło. Klucz działa przez 24 godziny, na dowolnej liczbie serwerów.

bash <(curl -s https://repo.konrado.ai/init.sh) --api-key=YOUR_KEY --callback-url=https://app.konrado.ai/api/integrations/servers/install --platform=solus

Odpowiedz instalatorowi. Pyta o kilka ustawień, każde ma wartość domyślną: naciśnij Enter, aby ją zachować. Liczą się dwie odpowiedzi. Aby później aktualizować wtyczkę z konsoli, odpowiedz Yes na pytanie Do you want to be able to upgrade this plugin through the Konrado panel? Adres serwera, który proponuje, na przykład http://203.0.113.10:8000/mcp, to adres, pod którym Konrado łączy się z wtyczką.

Instalator pyta też o SOLUSVM2_URL, czyli adres Twojego panelu (proponuje http:// z własnym adresem IP serwera), oraz o SOLUSVM2_API_TOKEN, czyli utworzony token API. Token nie ma wartości domyślnej: wklej go, aby przejść dalej.

Poczekaj na połączenie. Okno pokazuje Nasłuchiwanie serwera… i sprawdza co 5 sekund. Gdy wtyczka się zgłosi, pokazuje Połączono pomyślnie i adres serwera. Kliknij Gotowe. Okno możesz zamknąć wcześniej: serwer pojawi się na liście, gdy się połączy. Ponowne uruchomienie polecenia jest bezpieczne.

Sprawdź, czy działa

Panel jest na stronie Integracje ze stanem Połączono. W kolumnie Typ widać SolusVM 2 · API, bez wersji pod spodem. To normalne. Konrado testuje połączenie ponownie co godzinę. Otwórz wiersz: zakładka Narzędzia pokazuje pięć sprawdzeń.

Aby później zmienić token, otwórz wiersz, kliknij Zmień obok pola Token API, wklej nowy token i kliknij Zapisz.

Serwer jest na stronie Integracje ze statusem Połączono. Jego Typ to SolusVM 2 · Wtyczka, z wersją wtyczki pod spodem. Wiersz nazywa się solus Server: kliknij go, aby zmienić nazwę. Ponowne uruchomienie polecenia instalacji przywraca tę nazwę. Konrado sprawdza połączenie co godzinę.

Jeśli coś nie działa

Otwórz wiersz na stronie Integracje. Przy połączeniu, które przestało działać, widać stan Nie działa, co sprawdzić i dokładny błąd w sekcji Szczegóły techniczne.

Co widziszCo zrobić
SolusVM URL must use HTTPS.Wpisz pełny adres https://. Zwykły HTTP nie działa
SolusVM URL cannot contain credentials, query parameters, or a fragment.Wpisz sam adres, np. https://panel.example.com
Blocked: target resolves to a private/internal addressUżyj publicznej nazwy hosta. Konrado odrzuca adresy prywatne i wewnętrzne
SolusVM TLS verification failed.Zainstaluj ważny certyfikat dla nazwy hosta panelu, z pełnym łańcuchem
SolusVM rejected the configured API token.Sprawdź, czy skopiowano cały token i czy nadal istnieje w Access › API Tokens
This SolusVM token cannot read that resource.Sprawdź rolę użytkownika, do którego należy token
The SolusVM API request timed out.Sprawdź, czy panel odpowiada przez HTTPS i czy firewall lub WAF wpuszcza adresy IP Konrado (zobacz listę)
Połączono, ale odpowiedzi nigdy nie wspominają o VPSSprawdź, czy usługa w Twoim systemie rozliczeniowym jest na tym panelu i ma zapisane ID VM z SolusVM
Co widziszCo zrobić
Polecenie od razu się zatrzymujeUruchom je jako root na serwerze SolusVM 2
Komunikat Nasłuchiwanie serwera… się nie zmieniaSprawdź, czy instalator skończył bez błędów i czy serwer łączy się z app.konrado.ai przez HTTPS. Po 2 minutach okno pokazuje Trwa dłużej niż zwykle? z tymi samymi wskazówkami
Połączono, ale brak danych o VPSSprawdź SOLUSVM2_URL i SOLUSVM2_API_TOKEN w /opt/KonradoAi/.env, a potem uruchom systemctl restart konrado-server konrado-root
Odpowiedzi nigdy nie wspominają o VPSSprawdź, czy usługa w Twoim systemie rozliczeniowym ma zapisane ID VM z SolusVM

Krok instalacji pokazuje Błąd połączenia. Podaje adres serwera i przyczynę. Sprawdź obie usługi wtyczki, przeczytaj ich ostatnie logi i uruchom je ponownie:

systemctl status   konrado-server.service konrado-root.service
journalctl         -u konrado-server.service -u konrado-root.service --since "15 minutes ago" --no-pager
systemctl restart  konrado-server.service konrado-root.service
systemctl enable   konrado-server.service konrado-root.service
ss -ltnp | grep ':8000'

Ostatni wiersz pokazuje, czy wtyczka nasłuchuje na porcie 8000. Konrado musi mieć dostęp do tego portu: zezwól na adresy IP Konrado w swojej zaporze. Potem uruchom polecenie instalacji ponownie.

Usuń integrację

Otwórz Ustawienia obszaru roboczegoIntegracje, otwórz menu wiersza (trzy kropki) i wybierz Usuń. Potem usuń token w SolusVM 2 w Access › API Tokens.

Aby tylko wstrzymać działanie i zachować ustawienia, wybierz zamiast tego Odłącz.

Odinstaluj wtyczkę z serwera, a potem otwórz Ustawienia obszaru roboczegoIntegracje, otwórz menu wiersza (trzy kropki) i wybierz Usuń. Usuń też token SolusVM 2, jeśli nic innego z niego nie korzysta.

Aby tylko wstrzymać działanie i zachować ustawienia, wybierz zamiast tego Odłącz.

Ostatnia aktualizacja:

Na tej stronie