Storegate CLI

2 artiklar J Av Joakim

Storegate CLI (sgcli) Användarmanual

Storegate CLI (sgcli) Användarmanual Introduktion sgcli är ett kommandoradsverktyg (CLI) för att hantera din Storegate-lagring direkt från terminalen. Det stöder snabba, återupptakbara filöverföringar, rekursiva katalogoperationer, server-sida kopiering/flytt och en interaktiv filhanterare med dubbla paneler. Nyckelfunktioner: - Multiplattform: Fungerar på Windows, macOS och Linux. - Återupptakbara överföringar: Avbrutna upp- och nedladdningar återupptas automatiskt från avbrytspunkten. - Rekursiva operationer: Ladda upp eller ner hela mappstrukturer med ett enda kommando. - Server-sida-hastighet: Kopiera och flytta filer direkt på servern — ingen lokal bandbredd används för själva överföringen. - Interaktiv TUI: En fullfjädrad filhanterare med dubbla paneler (sgcli tui). - Versionsnotiser: Notifierar automatiskt när en nyare version finns tillgänglig. 1. Installation Ladda ner det färdigbyggda arkivet för ditt operativsystem från Releases-sidan. Arkivnamn | Plattform | Arkivfilnamn | |-----------|-------------| | macOS (Apple Silicon M1/M2/M3) | sgcli-darwin-arm64.tar.gz | | macOS (Intel) | sgcli-darwin-amd64.tar.gz | | Linux (64-bit) | sgcli-linux-amd64.tar.gz | | Windows (64-bit) | sgcli-windows-amd64.zip | Varje arkiv innehåller en enda binärfil: sgcli (eller sgcli.exe på Windows). macOS 1. Ladda ner .tar.gz-arkivet som matchar din Mac. 2. Packa upp det (dubbelklicka i Finder, eller i Terminal): tar -xzf sgcli-darwin-arm64.tar.gz 3. Installera genom att flytta binären till en katalog i din PATH: sudo mv sgcli /usr/local/bin/sgcli 4. Verifiera: sgcli --version Linux 1. Ladda ner .tar.gz-arkivet. 2. Packa upp: tar -xzf sgcli-linux-amd64.tar.gz 3. Installera: sudo mv sgcli /usr/local/bin/sgcli 4. Gör körbar (vid behov): chmod +x /usr/local/bin/sgcli 5. Verifiera: sgcli --version Windows 1. Ladda ner .zip-arkivet. 2. Packa upp det (högerklicka → Extrahera alla, eller använd 7-Zip). 3. Flytta sgcli.exe till en mapp som ingår i systemets PATH, till exempel C:\Tools. - Lägg till en mapp i PATH: Systeminställningar → Avancerat → Miljövariabler → Path → Redigera → Ny. 4. Verifiera genom att öppna en ny kommandotolk eller PowerShell-terminal: sgcli --version 2. Autentisering Logga in Innan du kan använda sgcli måste du logga in på ditt Storegate-konto. Processen använder OAuth2 och öppnar din webbläsare. sgcli login Efter lyckad inloggning sparar sgcli en krypterad sessionsfil: | Plattform | Plats | |-----------|-------| | macOS / Linux | ~/.storegate_session.bin | | Windows | %USERPROFILE%\.storegate_session.bin | Sessionen uppdateras automatiskt när den löper ut — du behöver inte logga in igen. Logga ut sgcli logout Återkallar sessionen på servern och tar bort den lokala sessionsfilen. 3. Kommandon ls — Lista filer och mappar sgcli ls [FJÄRRSÖKVÄG] Listar innehållet i en fjärrkatalog. Standardvärde är roten (/) om ingen sökväg anges. sgcli ls / sgcli ls /Dokument/Rapporter put — Ladda upp sgcli put [LOKAL_SÖKVÄG] [FJÄRRSÖKVÄG] Laddar upp en lokal fil eller mapp rekursivt. Om en fil redan finns på destinationen erbjuds du att Skriva över (Overwrite), Hoppa över (Skip), tillämpa valet på Alla (All) återstående konflikter, eller Avsluta (Quit). | Flagga | Beskrivning | |--------|-------------| | -f, --force | Skriv över utan att fråga | # Ladda upp en enskild fil sgcli put ./video.mp4 /Videos # Ladda upp en hel mapp rekursivt sgcli put ./MittProjekt / # Tvinga överskrivning sgcli put config.json /Inställningar -f get — Ladda ner sgcli get [FJÄRRSÖKVÄG] [LOKAL_SÖKVÄG] Laddar ner en fjärrfil eller mapp rekursivt. Om en delvis nedladdad fil finns lokalt erbjuds du att Återuppta (Resume), Skriva över (Overwrite) eller Hoppa över (Skip) — i stället för ett generiskt överskrivningsfråga. | Flagga | Beskrivning | |--------|-------------| | -f, --force | Skriv över utan att fråga | # Ladda ner en fil till aktuell katalog sgcli get /Dokument/rapport.pdf . # Ladda ner en mapp sgcli get /Foton ./Nedladdningar -f cp — Server-sida kopiering sgcli cp [FJÄRRKÄLLA] [FJÄRRDESTINATION] Kopierar filer eller mappar direkt på servern. Ingen lokal bandbredd används. | Flagga | Beskrivning | |--------|-------------| | -f, --force | Skriv över om destinationen finns | sgcli cp /Dokument/rapport.pdf /Arkiv/ sgcli cp /Foton /Backup/Foton_Kopia mv — Flytta eller byt namn sgcli mv [FJÄRRKÄLLA] [FJÄRRDESTINATION] Flyttar eller byter namn på en fil eller mapp på servern. | Flagga | Beskrivning | |--------|-------------| | -f, --force | Hoppa över bekräftelse | # Byt namn sgcli mv /Dokument/utkast.txt /Dokument/slutlig.txt # Flytta till en mapp sgcli mv /bild.jpg /Foton/ rm — Ta bort sgcli rm [FJÄRRSÖKVÄG] Tar permanent bort en fil eller mapp. | Flagga | Beskrivning | |--------|-------------| | -f, --force | Ta bort utan bekräftelse | sgcli rm /Papperskorg/gammal_fil.txt sgcli rm /TempMapp -f mkdir — Skapa mapp sgcli mkdir [FJÄRRSÖKVÄG] Skapar en ny mapp (inklusive mellanliggande föräldramappar om de saknas). sgcli mkdir /Projekt/NyKund/Tillgångar touch — Skapa tom fil sgcli touch [FJÄRRSÖKVÄG] Skapar en ny tom fil på servern. | Flagga | Beskrivning | |--------|-------------| | -f, --force | Skriv över om filen finns | sgcli touch /Dokument/anteckningar.txt cat — Visa filinnehåll sgcli cat [FJÄRRFILENS_SÖKVÄG] Laddar ner och skriver ut innehållet i en fjärrtextfil till terminalen. sgcli cat /Inställningar/config.txt open — Öppna i standardprogram sgcli open [FJÄRRSÖKVÄG] Laddar ner filen till en tillfällig plats och öppnar den med systemets standardprogram för filtypen. Obs: Detta är skrivskyddat. Ändringar sparas inte tillbaka till Storegate. Använd F4 i TUI för att redigera och spara till molnet. sgcli open /Ekonomi/budget.xlsx diff — Jämför lokalt och fjärran sgcli diff [LOKAL_SÖKVÄG] [FJÄRRSÖKVÄG] Jämför en lokal mapp med en fjärrmapp och visar skillnaderna. | Status | Betydelse | |--------|-----------| | ✅ OK | Samma fil finns på båda platser (storlek och datum stämmer) | | 👉 SAKNAS (Fjärr) | Finns lokalt, saknas på servern | | 👈 SAKNAS (Lokalt) | Finns på servern, saknas lokalt | | ⚠️ STORLEK | Samma namn, olika filstorlek | | ⏰ TID | Samma storlek, olika ändringstid | | ❌ TYP | Fil på ett ställe, mapp på det andra | sgcli diff ./Foton /Backup/Foton df — Lagringsutrymme sgcli df Visar total kapacitet, använt utrymme och ledigt utrymme för ditt konto. du — Diskanvändning för en sökväg sgcli du [FJÄRRSÖKVÄG] Beräknar den totala storleken för en fjärrfil eller mapp. sgcli du /Videos web — Öppna webbgränssnittet sgcli web Öppnar ditt Storegate-konto i standardwebbläsaren. tui — Terminalbaserat användargränssnitt sgcli tui Startar den interaktiva filhanteraren med dubbla paneler (se avsnitt 4). 4. Terminalbaserat användargränssnitt (TUI) TUI ger en filhanterare med dubbla paneler: vänster panel visar ditt lokala filsystem, höger panel visar din Storegate-lagring i molnet. Kortkommandon | Tangent | Funktion | |---------|----------| | Tab | Växla aktiv panel | | F1 | Visa hjälp | | F2 | Växla sortering (Namn → Storlek → Datum) | | F3 | Visa filinnehåll | | F4 | Redigera fil (låser filen på servern, laddar upp vid sparande) | | Shift+F4 / Ctrl+N | Skapa ny tom fil (Touch) | | F5 | Kopiera markerade objekt — dialog där du kan ändra målsökvägen | | F6 | Flytta markerade objekt — dialog där du kan ändra målsökvägen | | Ctrl+E | Byt namn på markerat objekt | | F7 | Skapa mapp | | F8 / Del | Ta bort markerade objekt | | F9 | Markera filer med mönster (t.ex. *.txt) | | F10 | Avsluta | | F12 | Växla panel mellan Lokal / Fjärr-vy | | Space | Markera / avmarkera objekt | | Ctrl+A | Markera alla | | + / - | Markera / avmarkera med mönster | | * | Invertera markering | | Esc | Avbryt pågående överföring (när en överföring pågår) | | Ctrl+C | Avbryt pågående överföring, eller avsluta om ingen överföring pågår | Kopiera- och Flytta-dialoger (F5 / F6) När du kopierar eller flyttar öppnas en dialog förifylld med målsökvägen. Du kan: - Redigera sökvägen för att flytta filer till en annan plats. - Ändra filnamnet för att byta namn i samband med kopiering eller flytt. Överföringsförlopp En förloppsruta visas under upp- och nedladdningar med filnamn, förloppsindikator och antal överförda byte. Tryck Esc eller Ctrl+C för att avbryta. 5. Skal-autokomplettering Aktivera tab-komplettering för kommandon och fjärrsökvägar. Bash Lägg till i ~/.bashrc eller ~/.bash_profile: source <(sgcli completion bash) Ladda om med source ~/.bashrc eller öppna en ny terminal. Zsh Lägg till i ~/.zshrc: source <(sgcli completion zsh) Ladda om med source ~/.zshrc eller öppna en ny terminal. Fish Kör en gång: sgcli completion fish > ~/.config/fish/completions/sgcli.fish PowerShell Öppna din profilfil för redigering: notepad $PROFILE Lägg till följande rad och spara: . (sgcli completion powershell | Out-String) Ladda om med . $PROFILE eller öppna en ny PowerShell-terminal. 6. Versionsnotiser sgcli kontrollerar automatiskt om en ny version finns tillgänglig efter varje kommando. Om en nyare version finns visas en notis: 💡 New version available! Download: https://example.com/sgcli-1.1.0-darwin-arm64.tar.gz Notisen skrivs även till loggfilen, vilket gör den synlig även när utdata omdirigeras (t.ex. i cron-jobb). Kontrollen är tyst vid alla fel (nätverksproblem, timeouts m.m.) och blockerar aldrig kommandot från att slutföras. 7. Globala flaggor Dessa flaggor kan användas med vilket kommando som helst: | Flagga | Beskrivning | |--------|-------------| | --no-log | Inaktivera skrivning av loggfiler till disk | | --help | Visa hjälp för ett kommando | | --version | Visa aktuell version | Loggfiler skrivs till: | Plattform | Plats | |-----------|-------| | macOS | ~/Library/Logs/sgcli/ | | Linux | ~/.local/state/sgcli/logs/ | | Windows | %LOCALAPPDATA%\sgcli\Logs\ |

Storegate CLI Systemkrav

Detta dokument beskriver systemkraven för den kompilerade applikationen sgcli (Storegate CLI) på olika plattformar. 🌍 Allmänna krav - Gäller endast företagskonton - Internetanslutning: Krävs för kommunikation med Storegate Cloud API. - Webbläsare: Krävs för den initiala inloggningsprocessen (OAuth2-autentisering). - Terminalstöd: En terminal med stöd för ANSI escape codes krävs för det grafiska terminalgränssnittet (TUI). - Lagringsrättigheter: Läs- och skrivrättigheter i användarens hemkatalog för att spara sessions-tokens (.storegate_session.bin). 🍎 macOS - Arkitekturer: Intel (amd64) och Apple Silicon (arm64). - OS-version: macOS 11 (Big Sur) eller senare rekommenderas. - Funktioner: Använder systemkommandot open för att starta webbläsaren vid inloggning. 🐧 Linux - Arkitektur: 64-bit (amd64). - Distributioner: De flesta moderna Linux-distributioner (t.ex. Ubuntu, Fedora, Debian). - Beroenden: xdg-open rekommenderas för att automatiskt starta webbläsaren. Om det saknas måste inloggningslänken öppnas manuellt. 🪟 Windows - Arkitektur: 64-bit (amd64). - OS-version: Windows 10 eller Windows 11. - Terminal: Windows Terminal rekommenderas starkt för den bästa TUI-upplevelsen. - Funktioner: Använder rundll32 för att starta standardwebbläsaren vid inloggning. 🛠️ Teknisk sammanfattning Applikationen är kompilerad som en statiskt länkad binär, vilket innebär att den är självförsörjande och inte kräver externa körtidsmiljöer som .NET, Java eller Python. Den har inga externa beroenden av bibliotek (DLL-filer/Shared Objects) utöver vad som ingår som standard i operativsystemet. Ladda ner applikationen