Inofficiell
På den här sidan
  1. 01Installera paketet
  2. 02Ange administratörslösenordet
  3. 03Aktivera modulerna
  4. 04Lägg till ett konto
  5. 05Klona ett förråd
  6. 06Öppna redigeraren
  7. 07Bygg en app
  8. 08Kör, ladda ner eller exportera appen
  9. 09App Center-förrådet på din NAS

Min första Linux-build: installera utvecklingsmiljön Bucket & Code på QNAP

Bucket & Code Server IDE samlar Git (Forgejo), Subversion, versionshanterade WebDAV-buckets, VS Code i webbläsaren och en App Builder på din NAS, bakom en enda panel med egna konton. Guiden börjar med en ny installation från App Center och slutar med en app som är byggd från recept och körs på NAS:en.

  1. Installeraett förråd i App Center
  2. Lösenordinom 60 minuter, från LAN:et
  3. ModulerGit, CI, SVN, Redigerare
  4. Kontonett för varje person
  5. Första appenbygg, aktivera sedan

Bilderna kommer från panelen med varje fält ifyllt så som den här guiden beskriver. Adresserna i dem tillhör en NAS på 192.168.1.20 med standardportarna.

01Installera paketet

Paketet kräver en x86_64-NAS med QTS 6.0 eller QuTS hero 6.0 eller nyare. App Center installerar det med standardinställningarna.

  1. App Center → ⚙ Inställningar → Appförråd → Lägg till. Namnge det QNAP Utilities, klistra in https://www.qnaputilities.com/repo.xml och tryck på Lägg till.
  2. Öppna QNAP Utilities i den vänstra listen och installera Bucket & Code Server IDE.
  3. Paketets data hamnar i BucketVS på den volym där paketet är installerat, till exempel /share/CACHEDEV1_DATA/BucketVS. Du kan senare flytta mappen till en annan volym på sidan Lagring.
  4. Knappen Öppna i App Center tar dig till panelen: https://<NAS address>:9951 eller http://<NAS address>:9950. HTTPS-adressen använder till en början ett självsignerat certifikat, så webbläsaren visar en varning tills din enhet litar på certifikatet.

02Ange administratörslösenordet

En ny installation har inget konto och öppnas på skärmen Sätt administratörslösenordet för kontot administrator. Skriv ett lösenord på minst 10 tecken två gånger och tryck på Sätt lösenordet och logga in.

Administratörslösenord för kontot administrator: Nytt lösenord och Upprepa det nya lösenordet ifyllda, Minst 10 tecken och Båda inmatningarna stämmer bockade, och knappen Sätt lösenordet och logga in
  • Skärmen tar emot ett lösenord i 60 minuter efter att paketet har startat. Efter det startar du om paketet i App Center, så får du 60 minuter till.
  • Lösenordet kan bara anges från en webbläsare i det lokala nätverket, och bara direkt, inte via en proxy. Medan skärmen väntar visar QTS systemloggar vilken adress du ska öppna.
  • Du kan inte logga in i panelen med ett QTS-konto: panelen har egna konton.

03Aktivera modulerna

Git, CI, SVN & Bucket och Redigerare är avstängda vid en ny installation. På Översikt har varje modul en ruta som beskriver vad den ger, med en egen knapp: Slå på Git, Slå på Redigerare och så vidare. Knappen kör ett jobb som förbereder modulen och startar den, och rutan visar körs när den är klar. CI kräver Git: så länge Git är avstängt heter knappen Slå på Git och CI.

Git-rutan på Översikt medan Git är avstängt: Forgejo 15.0.9, av, vad Git ger och knappen Slå på Git

04Lägg till ett konto

Med ett och samma konto loggar du in i panelen, Git, SVN och Bucket, med samma namn och lösenord. På sidan Användare trycker du på Nytt konto.

  1. Användarnamn: gemener, till exempel ola. Det är också användarnamnet i Forgejo.
  2. Roll: viewer kan läsa, developer kan dessutom öppna redigeraren och bygga appar, och admin kan göra allt.
  3. Lösenord: minst 10 tecken, eller tryck på Generera. Lämna Måste välja ett eget lösenord vid första inloggningen ibockad och tryck sedan på Skapa kontot.
Dialogrutan Nytt konto: Användarnamn ola, Roll developer med varningen om root-skalet, ett lösenord, Måste välja ett eget lösenord vid första inloggningen ibockad och knappen Skapa kontot

Redigerarens terminal är ett root-skal på NAS:en, och en utvecklares schemalagda jobb körs också som root. Ge rollen developer bara till personer som du skulle anförtro NAS:ens admin-lösenord.

05Klona ett repository

Knappen Öppna Forgejo på sidan Git tar dig till Forgejo, där du skapar, importerar och speglar repositorier. Nytt repository i sidans kort I Forgejo öppnar Forgejos formulär för ett nytt. Forgejo loggar in dig med din panelsession. På samma sida skriver Klona ett repository ut klonkommandona för en ägare och ett repository.

Klona ett repository: Ägare ola, Repository firmware, git clone ssh://git@192.168.1.20:9952/ola/firmware.git och git clone http://192.168.1.20:9950/git/ola/firmware.git
  • Över HTTP eller HTTPS använder git ditt panelanvändarnamn och lösenord. Om tvåfaktorsautentisering är på använder du en åtkomsttoken från Forgejo i stället för lösenordet (Forgejos Inställningar → Applications).
  • Över SSH, på port 9952, använder git en nyckel som du lägger till i Forgejo under Inställningar → SSH / GPG keys.

06Öppna redigeraren

På sidan Redigerarinställningar trycker du på Öppna redigeraren. VS Code öppnas i en ny flik, i mappen projects i datamappen. Varje konto får en egen instans.

Sidan Redigerarinställningar och dess knapp Öppna redigeraren
VS Code i webbläsaren: Explorer på mappen projects och välkomstsidan för code-server
Redigeraren. I dess terminal finns git, svn, node, npm, rsync och curl från paketet. En instans stoppas efter 30 minuter utan webbläsartrafik, men aldrig medan ett program som startats från den fortfarande körs.

07Bygg en app

App Builder kompilerar program från recept till en enda mapp, appens prefix. Varje recept anger sin källkod med en kontrollsumma, vilka andra recept det behöver och ett test som visar att resultatet går att köra. På sidan Appar trycker du på Ny app.

  1. Konfigurera. Skriv ett Namn, till exempel mytools. Prefix följer med och blir /usr/app/mytools. Under Byggmiljö väljer du miljön. En ny installation har ingen byggmiljö: tryck på Skapa en Builder-miljö (admin). Den förbereder Ubuntu 24.04 med byggverktygen och väljer miljön när den är klar. Tryck sedan på Välj recept. Namn och prefix: Namn mytools, Prefix /usr/app/mytools; Miljö: Byggmiljö ubuntu2404-builder, ubuntu-24.04-x86_64, glibc 2.39
  2. Recept. Sök efter ett program och bocka i det. De beroenden som programmet kräver läggs till automatiskt, i byggordning: tmux tar med libevent och ncurses. Tryck på Granskning. Recept: Recept från ett projekt inställt på Inget: bara biblioteket, sökningen tmux, tmux 3.7c ibockad, 1 vald och 3 recept i byggetByggordning: libevent och ncurses som tmux behöver, sedan tmux; Debian-paketen cmake och ninja-build; knapparna Tillbaka och Granskning
  3. Granska och bygg. Kontrollera sammanfattningen och tryck på Skapa och bygg. Granskning: Namn mytools, Prefix /usr/app/mytools, Miljö ubuntu2404-builder, Byggd för x86_64, Körs på varje NAS som paketet körs på, Länkningssätt dynamisk, 3 recept; Innan den bygger: Debian-paketen, licenserna och knappen Skapa och bygg

Låt Körs på stå kvar på varje NAS som paketet körs på. Då får inget program kräva en nyare glibc än 2.39, så appen fungerar även på andra x86_64-NAS-enheter med QTS 6.0, QuTS hero 6.0 eller nyare.

08Kör, ladda ner eller exportera appen

Appens sida visar dess pipeline: bygget, en QPKG-export och publicering.

Pipeline: Bygge, Byggd; Export som QPKG; Publicering, Kräver en export
  • Aktivera (admin) gör prefixet till en länk till det senaste lyckade bygget, så att programmen körs som /usr/app/<name>/bin/…. Paketet skapar länken igen vid varje start. På den här NAS:en: Inte aktiv, knappen Aktivera och datumet för bygget som aktiveringen använder
  • Ladda ner ger dig det senaste lyckade bygget som ett .tar.zst-arkiv.
  • Exportera som QPKG (admin) packar bygget som ett QPKG. Med det kan du installera appen på en annan NAS som saknar det här paketet. Exporten kräver QDK: installera QNAP QDK 2.5.0 på sidan Verktygskedjor, under fliken QNAP. Det exporterade paketet saknar kodsignatur, så repositoryt på sidan Paket tar inte emot det som det är.

09App Center-repositoryt på din NAS

Sidan Paket är ett App Center-repository på den här NAS:en. Lägg in dess adress i App Center på dina andra NAS-enheter: ⚙ Settings → App Repository → Lägg till.

App Center-adress: http://192.168.1.20:9950/repo/repo.xml

En utvecklare laddar upp en kodsignerad QPKG dit, och en admin väljer vilken version App Center erbjuder. Användarguiden beskriver resten, till exempel säkerhetskopior, publicering på internet och kernel-verkstaden.