diff --git a/web/support/kb/openstack/rclone_quick_tutorial.rst b/web/support/kb/openstack/rclone_quick_tutorial.rst index 17559dedef2d43da94cc698d6d8278ce71a7e13e..da0951f1de2fca7e8b9463b4ed8ab3ebecfb20fb 100644 --- a/web/support/kb/openstack/rclone_quick_tutorial.rst +++ b/web/support/kb/openstack/rclone_quick_tutorial.rst @@ -1,14 +1,30 @@ Rclone quick tutorial ===================== + Installing and configuring -########################## +-------------------------- If not yet installed on your machine, you can install **rclone** with the following command:: $ curl https://rclone.org/install.sh | sudo bash -download rc file v3 from openstack dashboard as **openstack-credential.sh** +Then edit the Rclone configuration file:: + + $ nano .rclone.conf + +to look like this: + +.. code-block:: + + [garr-cloud] + type = swift + env_auth = true + +Access with password +^^^^^^^^^^^^^^^^^^^^ + +Download rc file v3 from openstack dashboard as **openstack-credential.sh** .. figure:: ../../images/rc_file.png :scale: 60% @@ -17,24 +33,25 @@ Then execute the content of the file:: $ source openstack-credential.sh -and edit the Rclone configuration file:: +Access with application credential +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - $ nano .rclone.conf - -to look like this: +Create and download an application credential from openstack dashboard as **app-credentials.sh** -.. code-block:: +Then execute the content of the file:: - [garr-cloud] - type = swift - env_auth = true + $ source app-credentials.sh + + +Check the functionalities +^^^^^^^^^^^^^^^^^^^^^^^^^ -Now you can verify the functionalities with:: +Now, in both cases, you can verify the functionalities with:: $ rclone lsd garr-cloud: Copy files and directories to cloud -################################### +----------------------------------- Make a **container** on your remote object store:: @@ -70,7 +87,7 @@ Execute the following command to synchronize it with the remote:: Copy files from remote to local -############################### +------------------------------- The following command copies files from remote to a local directory, create it if not exists::