Moja pierwsza kompilacja w Linuksie: instalacja środowiska Bucket & Code na QNAP

Bucket & Code Server IDE udostępnia na NAS-ie Git (Forgejo), Subversion, wersjonowane buckety WebDAV, VS Code w przeglądarce i App Builder. Wszystkim zarządzasz w jednym panelu, który ma własne konta. Poradnik zaczyna się od instalacji pakietu z App Center, a kończy na aplikacji zbudowanej z przepisów i uruchomionej na NAS-ie.

Instalacjajedno repozytorium w App Center
Hasłow ciągu 60 minut, z sieci LAN
ModułyGit, CI, SVN, Edytor
Kontaosobne dla każdej osoby
Pierwsza aplikacjazbuduj, a następnie aktywuj

Zrzuty ekranu pochodzą z panelu. Pola wypełniono zgodnie z opisem w poradniku. Widoczny na nich NAS ma adres 192.168.1.20 i korzysta z domyślnych portów.

01Zainstaluj pakiet

Potrzebny jest NAS z procesorem x86_64 i systemem QTS 6.0 lub QuTS hero 6.0 albo nowszym. App Center instaluje pakiet przy domyślnych ustawieniach.

App Center → ⚙ Ustawienia → Repozytorium aplikacji → Dodaj. Wpisz nazwę QNAP Utilities, wklej adres https://www.qnaputilities.com/repo.xml i naciśnij Dodaj.
Otwórz QNAP Utilities na lewym pasku i zainstaluj Bucket & Code Server IDE.
Dane trafiają do katalogu BucketVS na woluminie, na którym zainstalowano pakiet, na przykład /share/CACHEDEV1_DATA/BucketVS. Później możesz przenieść je na inny wolumin na stronie Miejsce na dane.
Przycisk Otwórz w App Center otwiera panel pod adresem https://<NAS address>:9951 lub http://<NAS address>:9950. Początkowo HTTPS korzysta z certyfikatu z podpisem własnym. Przeglądarka wyświetla ostrzeżenie, dopóki urządzenie nie zaufa temu certyfikatowi.

02Ustaw hasło administratora

Po nowej instalacji nie ma jeszcze konta. Otwiera się ekran Ustaw hasło administratora dla konta administrator. Wpisz dwukrotnie hasło liczące co najmniej 10 znaków i naciśnij Ustaw hasło i zaloguj się.

Konfiguracja konta administrator: wypełnione pola nowego hasła i jego powtórzenia, potwierdzone wymagania co najmniej 10 znaków i zgodności obu wpisów oraz przycisk zapisania i zalogowania

Hasło można ustawić przez 60 minut od uruchomienia pakietu. Po tym czasie uruchom pakiet ponownie w App Center: dostaniesz kolejne 60 minut.
Hasło można ustawić tylko z przeglądarki w sieci lokalnej, przez połączenie bezpośrednie, bez serwera proxy. Gdy panel czeka na ustawienie hasła, w dziennikach systemowych QTS znajdziesz adres, który należy otworzyć.
Konta QTS nie służą do logowania w panelu. Panel ma własne konta.

03Włącz moduły

Po nowej instalacji Git, CI, SVN & Bucket oraz Edytor są wyłączone. Na stronie Przegląd każdy moduł ma kafelek z opisem i przyciskiem, np. Włącz Git lub Włącz Edytor. Przycisk uruchamia zadanie, które przygotowuje i włącza moduł. Gdy moduł jest gotowy, kafelek pokazuje stan działa. CI wymaga Git: gdy Git jest wyłączony, przycisk ma napis Włącz Git i CI.

Kafelek Git na stronie Przegląd, gdy Git jest wyłączony: Forgejo 15.0.9, stan wyłączony, opis modułu i przycisk Włącz Git

04Dodaj konto

Tą samą nazwą konta i tym samym hasłem logujesz się do panelu, Git, SVN i Bucket. Na stronie Konta naciśnij Nowe konto.

Nazwa użytkownika: małymi literami, na przykład ola. To także nazwa użytkownika w Forgejo.
Rola: viewer ma dostęp do odczytu, developer może też otwierać edytor i budować aplikacje, a admin ma pełne uprawnienia.
Hasło: co najmniej 10 znaków. Możesz też nacisnąć Wygeneruj. Pozostaw zaznaczone Przy pierwszym logowaniu musi ustawić własne hasło i naciśnij Utwórz konto.

Okno nowego konta: nazwa użytkownika ola, rola developer z ostrzeżeniem o powłoce root, hasło, zaznaczony wymóg zmiany hasła przy pierwszym logowaniu i przycisk tworzenia konta

Terminal edytora udostępnia powłokę root na NAS-ie. Zaplanowane zadania konta z rolą developer również działają jako root. Nadawaj tę rolę tylko osobom, którym możesz powierzyć hasło administratora NAS-a.

05Sklonuj repozytorium

Przycisk Otwórz Forgejo na stronie Git otwiera Forgejo, gdzie możesz tworzyć i importować repozytoria oraz ich kopie lustrzane. Nowe repozytorium w sekcji W Forgejo otwiera formularz tworzenia repozytorium. Do Forgejo nie logujesz się osobno: Forgejo używa sesji panelu. Na tej samej stronie sekcja Sklonuj repozytorium podaje polecenia klonowania dla wskazanego właściciela i repozytorium.

Klonowanie repozytorium: właściciel ola, repozytorium firmware, git clone ssh://git@192.168.1.20:9952/ola/firmware.git i git clone http://192.168.1.20:9950/git/ola/firmware.git

Przy połączeniu HTTP lub HTTPS git używa nazwy użytkownika i hasła z panelu. Jeśli masz włączone uwierzytelnianie dwuskładnikowe, zamiast hasła użyj tokenu dostępu Forgejo (Ustawienia → Applications w Forgejo).
Przy połączeniu SSH na porcie 9952 git używa klucza dodanego w Forgejo w sekcji Ustawienia → SSH / GPG keys.

06Otwórz edytor

Na stronie Ustawienia edytora naciśnij Otwórz edytor. VS Code otworzy się w nowej karcie, w katalogu projects w folderze danych. Każde konto ma własny, osobny edytor.

Strona Ustawienia edytora z przyciskiem otwierania edytora

VS Code w przeglądarce: Eksplorator z katalogiem projects i strona powitalna code-server — **Edytor.** W terminalu masz git, svn, node, npm, rsync i curl dostarczone z pakietem. Edytor zatrzymuje się po 30 minutach bez połączeń z przeglądarki, chyba że działa w nim jeszcze uruchomiony program.

07Zbuduj aplikację

App Builder kompiluje programy według przepisów i umieszcza je w jednym katalogu, nazywanym prefiksem aplikacji. Każdy przepis podaje źródło z sumą kontrolną, przepisy, których wymaga, i test, który uruchamia gotowy program. Na stronie Aplikacje naciśnij Nowa aplikacja.

Konfiguracja. W polu Nazwa wpisz na przykład mytools. Pole Prefiks wypełni się wtedy wartością /usr/app/mytools. W polu Środowisko budowania wybierz środowisko. Początkowo nie ma żadnego: naciśnij Utwórz środowisko Builder (admin). Panel przygotuje Ubuntu 24.04 z narzędziami do kompilacji i wybierze gotowe środowisko. Następnie naciśnij Wybierz przepisy.
Przepisy. Wyszukaj program i zaznacz go. Programy, których wymaga, zostaną dodane same, w kolejności kompilacji: tmux wymaga libevent i ncurses. Naciśnij Podsumowanie.
Podsumowanie i budowanie. Sprawdź podsumowanie i naciśnij Utwórz i zbuduj.

W polu Działa na pozostaw każdy NAS, na którym działa pakiet. Żaden program nie może wtedy wymagać glibc nowszej niż 2.39, dzięki czemu aplikacja działa także na innych NAS-ach x86_64 z QTS 6.0, QuTS hero 6.0 lub nowszym.

08Uruchom, pobierz lub wyeksportuj aplikację

Strona aplikacji pokazuje potok: budowanie, eksport do QPKG i publikowanie.

Potok: Budowanie, Zbudowano; Eksport do QPKG; Publikowanie, Wymaga eksportu

Aktywuj (admin) tworzy pod prefiksem dowiązanie do ostatniej udanej kompilacji. Programy uruchamiasz wtedy ze ścieżki /usr/app/<name>/bin/…. Pakiet odtwarza dowiązanie przy każdym uruchomieniu.
Pobierz udostępnia ostatnią udaną kompilację jako archiwum .tar.zst.
Eksportuj jako QPKG (admin) pakuje kompilację do pliku QPKG, który instaluje aplikację na innym NAS-ie. Na tamtym NAS-ie ten pakiet nie jest potrzebny. Wymagany jest QDK: na stronie Toolchainy, w zakładce QNAP, zainstaluj QNAP QDK 2.5.0. Wyeksportowany pakiet nie ma podpisu cyfrowego, więc repozytorium na stronie Pakiety go nie przyjmie, dopóki nie zostanie podpisany.

09Repozytorium App Center na Twoim NAS-ie

Strona Pakiety udostępnia repozytorium App Center na tym NAS-ie. Jego adres dodaj w App Center na pozostałych NAS-ach: ⚙ Ustawienia → Repozytorium aplikacji → Dodaj.

Adres App Center: http://192.168.1.20:9950/repo/repo.xml

Konto z rolą developer przesyła tam podpisany cyfrowo plik QPKG, a admin wybiera wersję oferowaną przez App Center. Pozostałe funkcje, w tym kopie zapasowe, publikację w internecie i warsztat jądra, opisuje przewodnik.