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:14] danecek@cesnet.cz |
cs:navody:ltp:start [09.07.2020 13:51] Milan Daneček |
||
---|---|---|---|
Řá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 175: | Řádek 183: | ||
} | } | ||
</code></hidden> | </code></hidden> | ||
+ | /* | ||
\\ | \\ | ||
**GET Logout user** - zruší okamžitě platnost přihlašovacího uživatelského tokenu. | **GET Logout user** - zruší okamžitě platnost přihlašovacího uživatelského tokenu. | ||
Řádek 184: | Řádek 193: | ||
<hidden Příklad odpovědi><code>"Logout was successful."</code></hidden> | <hidden Příklad odpovědi><code>"Logout was successful."</code></hidden> | ||
\\ | \\ | ||
+ | */ | ||
====Správa archivních balíčků==== | ====Správa archivních balíčků==== | ||
{{anchor:post_create:}} | {{anchor:post_create:}} | ||
Řádek 192: | Řádek 201: | ||
__Význam jednotlivých atributů je následující__ \\ | __Význam jednotlivých atributů je následující__ \\ | ||
//--form name=// název balíčku, pod kterým bude veden v našich systémech, mj. jej podle názvu bude možno vyhledávat ve webovém prostředí služby LTP \\ | //--form name=// název balíčku, pod kterým bude veden v našich systémech, mj. jej podle názvu bude možno vyhledávat ve webovém prostředí 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 201: | Řádek 209: | ||
--header 'cache-control: no-cache' \ | --header 'cache-control: no-cache' \ | ||
--header 'content-type: multipart/form-data' \ | --header 'content-type: multipart/form-data' \ | ||
- | --form name=bag-balicek \ | + | --form name=bag-balicek \\ |
- | --form content=@/home/user/my_archive_package.zip \ | + | |
--form 'user_metadata={"author": "milan", "title": "ltp_data1"}' \ | --form 'user_metadata={"author": "milan", "title": "ltp_data1"}' \ | ||
--form group='urn:geant:cesnet.cz:group:VO_ltp_pilot_catchall:ltp_test_group' | jq</code></hidden> | --form group='urn:geant:cesnet.cz:group:VO_ltp_pilot_catchall:ltp_test_group' | jq</code></hidden> |