persist

ARLAS Persistence

ARLAS Persistence allows you to place files within zones.

A zone is a group of files of the same nature (configurations, dashboard previews, bookmarks, ...)

A zone is visible by groups.

It is also possible to set who can access the file.

The main persistence zone is the config.json which contains the dashboard configurations.

An entry is an element stored in the persistence.

arlas_cli persist --helpUsage: arlas_cli persist [OPTIONS] COMMAND [ARGS]...

Options:
--config TEXT Name of the ARLAS configuration to use from your
configuration file
(/Users/gaudan/.arlas/cli/configuration.yaml).
--help Show this message and exit.

Commands:
add Add an entry, returns its ID
delete Delete an entry
describe Describe an entry
get Retrieve an entry
groups List groups allowed to access a zone
zone List entries within a zone

add

The persist add sub-command allows to create an entry from a file.

arlas_cli persist --config local add --helpUsage: arlas_cli persist add [OPTIONS] FILE ZONE

Add an entry, returns its ID

Arguments:
FILE File path [required]
ZONE zone [required]

Options:
--name TEXT name [default: none]
--reader TEXT Readers
--writer TEXT writers
--encode / --no-encode Encode in BASE64 [default: no-encode]
--help Show this message and exit.

See full arlas_cli documentation at
https://docs.arlas.io/external_docs/arlas_cli/

Add an entry from a file

For example to create an ARLAS dashboard directly from a json file, run the following command to add the entry to the config.json zone:

arlas_cli persist \ --config {local} \ add {path/to/config.dashboard.json} config.json \ --name {dashboard_name}32d2624b-d7cd-11ee-9a91-0242ac130004

The returned identifier is the entry unique identifier.

Note

The config.dashboard.json file has to contain all the dashboard configurations merged (config.json and config.map.json).

zone

The available entries in a zone can be listed with the persist zone sub-command:

arlas_cli persist --config local zone --helpUsage: arlas_cli persist zone [OPTIONS] ZONE

List entries within a zone

Arguments:
ZONE Zone name [required]

Options:
--help Show this message and exit.

See full arlas_cli documentation at
https://docs.arlas.io/external_docs/arlas_cli/

List entries within a zone

For example, to list all the available ARLAS dashboards (config.json zone), run the following command:

arlas_cli persist --config {local} zone config.json+--------------------------------------+-------------------+-------------+------------------+-----------+
| id | name | zone | last_update_date | owner |
+--------------------------------------+-------------------+-------------+------------------+-----------+
| 66984014-d0a1-11ee-b41c-0242ac190004 | Courses | config.json | 1708510231303 | anonymous |
...
+--------------------------------------+-------------------+-------------+------------------+-----------+

The id is the unique identifier of the entry.

describe

An entry (defined by its unique identifier) can be described with the persist describe sub-command:

arlas_cli persist --config local describe --helpUsage: arlas_cli persist describe [OPTIONS] ID

Describe an entry

Arguments:
ID entry identifier [required]

Options:
--help Show this message and exit.

See full arlas_cli documentation at
https://docs.arlas.io/external_docs/arlas_cli/

Describe an entry

For example, a dashboard configuration can be described by its metadata with the following command:

arlas_cli persist --config {local} describe {99acb6b7-3cfd-11ef-aee2-2e6497b109c4}+------------------+--------------------------------------------+
| metadata | value |
+------------------+--------------------------------------------+
| ID | 99acb6b7-3cfd-11ef-aee2-2e6497b109c4 |
| name | AIS Course |
| zone | config.json |
| last_update_date | 2024-10-21T18:02:59.456000 |
| owner | 6ce7f1f2-2ee3-4532-987d-26079c1b3043 |
| organization | gisaia.com |
| ispublic | False |
| updatable | True |
| readers | group/config.json/gisaia.com, group/public |
| writers | group/config.json/gisaia.com |
+------------------+--------------------------------------------+

In the metadata, we can find which organisation own the dashboard and which groups can access the dashboard as readers and writers.

get

The content of an entry can be accessed with the persist get sub-command:

arlas_cli persist --config local get --helpUsage: arlas_cli persist get [OPTIONS] ID

Retrieve an entry

Arguments:
ID entry identifier [required]

Options:
--help Show this message and exit.

See full arlas_cli documentation at
https://docs.arlas.io/external_docs/arlas_cli/

Get an entry value

The content of the configuration file of an ARLAS dashboard can be read directly from its entry unique identifier:

arlas_cli persist --config {local} get {32d2624b-d7cd-11ee-9a91-0242ac130004}{
"arlas": {
"web": {
"contributors": [
...
}

groups

The groups accessing a zone can be listed with the persist groups sub-command:

arlas_cli persist --config local groups --helpUsage: arlas_cli persist groups [OPTIONS] ZONE

List groups allowed to access a zone

Arguments:
ZONE Zone name [required]

Options:
--help Show this message and exit.

See full arlas_cli documentation at
https://docs.arlas.io/external_docs/arlas_cli/

List groups accessing a zone

For example, the groups accessing the dashboards config.json zone can be listed with the following command:

arlas_cli persist --config {local} groups config.json+-------------------------------+
| group |
+-------------------------------+
| group/config.json/gisaia.com |
| group/public |
+-------------------------------+

delete

An entry defined by its unique identifier can be deleted with the persist delete sub-command:

arlas_cli persist --config local delete --helpUsage: arlas_cli persist delete [OPTIONS] ID

Delete an entry

Arguments:
ID entry identifier [required]

Options:
--help Show this message and exit.

See full arlas_cli documentation at
https://docs.arlas.io/external_docs/arlas_cli/

Delete an entry

For example, to delete a dashboard from its identifier, run the following command:

arlas_cli persist --config {local} delete {32d2624b-d7cd-11ee-9a91-0242ac130004}Resource 32d2624b-d7cd-11ee-9a91-0242ac130004 deleted.

Warning

A deleted entry cannot be restored.