Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
Obě strany předchozí revize Předchozí verze Následující verze | Předchozí verze Následující verze Obě strany příští revize | ||
cs:navody:ltp:start [02.07.2019 15:01] danecek@cesnet.cz [Správa archivních balíčků] |
cs:navody:ltp:start [27.08.2019 16:33] lukasstrnad@cesnet.cz |
||
---|---|---|---|
Řádek 23: | Řádek 23: | ||
===Instalace nástroje bagit=== | ===Instalace nástroje bagit=== | ||
- | Pro instalaci je nezbytné nejprve nainstalovat balíček **python-pip**. Pro úspěšnou instalaci nástroje __bagit__ je nezbytné mít v systému **python v2.7 a vyšší**. Následně tedy můžeme provést instalaci (jako správce systému). \\ | + | Pro instalaci je nezbytné nejprve nainstalovat balíček **python-pip**. Pro úspěšnou instalaci nástroje __bagit__ je nezbytné mít v systému **python v3.0 a vyšší**. Následně tedy můžeme provést instalaci (jako správce systému). \\ |
<code>pip install bagit</code> | <code>pip install bagit</code> | ||
Řádek 79: | Řádek 79: | ||
*/ | */ | ||
- | Pro nahrání archivního balíčku je nezbytné vyplnit jeho název **File name**. Následně můžeme přidat uživatelská metadata **User metadata**. Nakonec vybereme z lokálního disku příslušný zabalený balíček ve formátu *.zip a klikneme na tlačítko **Store**. | + | Pro nahrání archivního balíčku je nezbytné vyplnit jeho název **File name**. Následně můžeme přidat uživatelská metadata **Package metadata**. Zde můžeme využít buď ručního vložení metadat ve fromátu json, případně můžeme nahrát metadata pomocí existujícího json souboru, nebo vyplnit identifikátory zcela ručně. Nakonec vybereme z lokálního disku příslušný zabalený balíček ve formátu *.zip a klikneme na tlačítko **Store**. |
<note warning>Pokud kontroly balíčku po vložení do systému neproběhnou správně, bude balíček označen jako nevalidní a po nějaké době bude automaticky odstraněn. Je tedy zcela zásadní po vkládání balíčku vždy zkontrolovat, že je balíček systémem korektně přijat. To je popsáno v auditních zprávách a ve stručné podobě také jako status balíčku.</note> | <note warning>Pokud kontroly balíčku po vložení do systému neproběhnou správně, bude balíček označen jako nevalidní a po nějaké době bude automaticky odstraněn. Je tedy zcela zásadní po vkládání balíčku vždy zkontrolovat, že je balíček systémem korektně přijat. To je popsáno v auditních zprávách a ve stručné podobě také jako status balíčku.</note> | ||
Řádek 85: | Řádek 85: | ||
{{:cs:navody:ltp:ltp3.png?700|}} | {{:cs:navody:ltp:ltp3.png?700|}} | ||
- | Po kliknutí na tlačítko **Store to LTP** dojde k nahrání archivního balíčku. | + | Po kliknutí na tlačítko **Store to LTP** dojde k nahrání archivního balíčku, o jehož průběhu vás bude informovat progress bar |
{{:cs:navody:ltp:ltp33.png?700|}} | {{:cs:navody:ltp:ltp33.png?700|}} | ||
Řádek 124: | Řádek 124: | ||
{{anchor:user_profile:}} | {{anchor:user_profile:}} | ||
=====Popis funkcí dostupných pomocí API===== | =====Popis funkcí dostupných pomocí API===== | ||
- | Pro přístup přes API rozhraní je nezbytné nejdříve získat přístupový API klíč. Klíč má platnost jeden den. | + | Pro přístup přes API rozhraní je nezbytné nejdříve získat přístupový API klíč. Klíč má omezenou platnost. |
- | Přístupový klíč si můžete zobrazit ve webovém prostředí při kliknutí na tlačítko **User Profile** v levém menu. | + | Přístupový klíč si můžete vygenerovat ve webovém prostředí při kliknutí na tlačítko **User Profile** v levém menu a následně na **Manage Tokens**. |
- | - Přihlásit se přes web na https://ltp.cesnet.cz/ \\ | + | |
- | - Klikněte v levém menu na tlačítko **User Profile** | + | |
- | - Na konci zobrazené stránky si skopírujte API klíč a uložte jej do proměnné | + | |
{{:cs:navody:ltp:ltp8.png?700|}} | {{:cs:navody:ltp:ltp8.png?700|}} | ||
+ | - Přihlásit se přes web na https://ltp.cesnet.cz/ \\ | ||
+ | - Klikněte v levém menu na tlačítko **User Profile** \\ | ||
+ | - Klikněte na talčítko **Manage Tokens** \\ | ||
+ | - Na zobrazené stránce vyplňte název tokenu a klikněte na tlačítko **Save Token** \\ | ||
+ | <note important>Token si prosím zkopírujte na bezpečné místo. Z bezpečnostních důvodů jej nebude možné později znovu zobrazit.</note> | ||
+ | |||
+ | {{:cs:navody:ltp:ltp9.png?700|}} | ||
+ | |||
+ | Pokud provedete obnovení stránky, dojde ke skrytí tokenu. Na zobrazené stránce pak můžete token rovněž revokovat. | ||
+ | |||
+ | {{:cs:navody:ltp:ltp10.png?700|}} | ||
<note tip>Doporučujeme **uložit si přístupový token do proměnné shellu**. Následně můžete v curl-příkazech použít tuto proměnnou.</note> | <note tip>Doporučujeme **uložit si přístupový token do proměnné shellu**. Následně můžete v curl-příkazech použít tuto proměnnou.</note> | ||
Řádek 194: | Řádek 202: | ||
//--form content=@// cesta k zabalenému balíčku, který chcete uložit do služby LTP \\ | //--form content=@// cesta k zabalenému balíčku, který chcete uložit do služby LTP \\ | ||
//--form 'user_metadata=// uživatelská metadata pro archivní balíček ve formě dvojic "klíč": "hodnota" \\ | //--form 'user_metadata=// uživatelská metadata pro archivní balíček ve formě dvojic "klíč": "hodnota" \\ | ||
- | //--form group=// plné jméno skupiny, členové dané skupiny budou moci spravovat daný balíček (download, update, ...). Celý název příslušné skupiny lze získat pomocí funkce [[#account_info|GET Account info]] případně skopírovat z webového prostředí z [[#user_profile|uživatelského profilu]]. \\ | + | //--form group=// plné jméno skupiny, členové dané skupiny budou moci spravovat daný balíček (download, update, ...). Celý název příslušné skupiny lze získat pomocí funkce [[#account_info|GET Account info]] případně zkopírovat z webového prostředí z [[#user_profile|uživatelského profilu]]. \\ |
<hidden Příklad dotazu><code>curl --request POST \ | <hidden Příklad dotazu><code>curl --request POST \ | ||
Řádek 596: | Řádek 604: | ||
] | ] | ||
</code></hidden> | </code></hidden> | ||
+ | /* | ||
{{anchor:stavove_kody:}} | {{anchor:stavove_kody:}} | ||
===== Stavové kódy archivních balíčků ===== | ===== Stavové kódy archivních balíčků ===== | ||
Řádek 610: | Řádek 618: | ||
NOT_VALID_BAGIT = '9' \\ | NOT_VALID_BAGIT = '9' \\ | ||
BAGIT_IS_VALID = '10' \\ | BAGIT_IS_VALID = '10' \\ | ||
+ | */ | ||
===== Záznam změn/Change Log ===== | ===== Záznam změn/Change Log ===== | ||
[[cs:navody:ltp:change_log:start|Soupis prováděných změn v souvislosti s funkcionalitami LTP]] | [[cs:navody:ltp:change_log:start|Soupis prováděných změn v souvislosti s funkcionalitami LTP]] | ||