Usługa rimrock jest dostępna pod następującym adresem:
Usługa rimrock pozwala na zarządzanie procesami i zadaniami na infrastrukturze obliczeniowej za pomocą interfejsów REST. Może być wykorzystana przez dostawców usług dziedzinowych lub zaawansowanych użytkowników do uruchamiania i monitorowania procesów lub zadań na infrastrukturze poprzez delegację certyfikatu proxy użytkownika. Certyfikat proxy można otrzymać z ramach uwierzytelnienia z serwerem OpenID lub wygenerować ręcznie (np. za pomocą polecenia voms-proxy-init
). Udostępniane metody REST obejmują:
zeus.cyfronet.pl
należy uruchomić polecenie module available. Można to zrobić logując się na maszynę za pomocą ssh
i wykonać wspomniane polecenie. Dzięki rimrock zadanie to można wykonać za pomocą metody REST przekazując nazwę hosta, polecenie oraz certyfikat proxy użytkownika na rzecz którego polecenie zostanie wykonane. Rezultat działania wybranego polecenia zostanie zwrócony wraz z odpowiedzią na żądanie wykonania polecenia.
Szczegóły dotyczące adresów oraz formatu wiadomości interfejsów REST znajdują się na dedykowanych stronach usługi, a linki do tych stron znajdują się w każdym z powyższych punktów.
Aby skorzystać z usługi należy, oprócz samej usługi rimrock, aktywować następujące usługi (wymagane jest posiadanie konta infrastruktury PL-Grid):
W celu otrzymywania certyfikatu proxy użytkownika za pomocą uwierzytelnienia poprzez OpenID potrzebne jest również wygenerowanie certyfikatu SimpleCA, co można uczynić korzystając z okienka Certyfikaty SimpleCA na zakładce Moje konto portalu PL-Grid.
Należy pamiętać, iż procesy oraz procesy interaktywne uruchamiane w ramach zadządzania procesami i zarządzania procesami interaktywnymi nie mogą być intensywne obliczeniowo ponieważ są uruchamiane na maszynie dostępowej (UI), z której korzystają też inni użytkownicy.
W poniższym przykładzie wykorzystamy zarządzanie procesami usługi rimrock do uruchomienia polecenia date
na maszynie dostępowej zeus.cyfronet.pl
. Wykorzystamy w tym celu powłokę systemu Linux (bash
) oraz narzędzie curl
. W pierwszej kolejności należy wygenerować certyfikat proxy użytkownika. Możemy to zrobić logując się na maszynę zeus.cyfronet.pl
i za pomocą polecenia grid-proxy-init
wygenerować certyfikat proxy. Następnie za pomocą poniższego polecenia odpowiednio przygotowujemy certyfikat i zapisujemy w zmiennej środowiskowej proxy
.
proxy="`cat {path-to-proxy-file} | base64 | tr -d '\n'`"
Fragment {path-to-proxy-file}
należy zamienić ścieżką do pliku z certyfikatem proxy (ścieżkę można odczytać po wykonaniu polecenia gri
d-proxy-info). Następnie wywołujemy jedną z metod usługi rimrock za pomocą następującego polecenia:
curl -k -X POST --data '{"host": "zeus.cyfronet.pl", "command": "date"}' --header "Content-Type:application/json" --header "PROXY:$proxy" https://submit.plgrid.pl/api/process
Polecenie zawiera wiadomość w formacie JSON zawierającą nazwę hosta (zeus.cyfronet.pl
) na którym zostanie wykonane komenda date
oraz definicję niezbędnych nagłówków i adres odpowiedniej metody. W rezultacie powinniśmy otrzymać odpowiedź podobną do tej poniżej.
{"status":"OK","exit_code":0,"standard_output":"Tue Dec 9 11:44:52 CET 2014","error_output":"","error_message":null}
Oprócz samego rezultatu działania polecenia date
wiadomość zawiera kod wyjścia uruchomionego polecenia, a w przypadku wystąpienia błędu stosowne pola będą zawierać komunikaty z błędami.
Szczegółowe informacje na temat poszczególnych zestawów operacji REST usługi rimrock można znaleźć na stronie samej usługi.