Rclone configureren voor OpenStack Object Store

Object Store is schaalbare opslag die je via onder andere de OpenStack Swift-API beheert. Met rclone upload, download en synchroniseer je bestanden vanaf Windows, macOS of Linux.

In deze handleiding installeer je rclone, download je de actuele projectgegevens uit Horizon, maak je de Swift-remote objectstore aan en controleer je lees- en schrijfrechten met een lege testcontainer.

Benodigdheden

• Object Store-project: een OpenStack-project waarvoor de Swift-API actief is.
• OpenStack-gebruiker: de gebruikersnaam en het bijbehorende wachtwoord voor het Object Store-project.
• Horizon: toegang tot het OpenStack-dashboard om clouds.yaml te downloaden.
• Lokale computer: een ondersteunde Windows-, macOS- of Linux-installatie waarop je rclone installeert.

Rclone installeren

Installeer rclone voor je besturingssysteem. Gebruik na de installatie rclone version om te controleren of de opdracht beschikbaar is.

C:\Program Files\rclone

C:\Program Files\rclone

rclone version

brew install rclone

rclone version

sudo -v ; curl https://rclone.org/install.sh | sudo bash

rclone version

clouds.yaml downloaden

Stap 1

Log in op het Horizon-dashboard en selecteer bovenaan het Object Store-project dat je met rclone wilt gebruiken.

Stap 2

Klik in het linkermenu op ‘Project’ > ‘API Access’.

Stap 3

Klik op ‘Download OpenStack RC File’ > ‘OpenStack clouds.yaml File’. Horizon downloadt het bestand clouds.yaml.

Open het bestand in een teksteditor. Een actuele download bevat deze structuur:

clouds:
  openstack:
    auth:
      auth_url: <auth-url>
      username: <gebruikersnaam>
      project_id: <project-id>
      project_name: <projectnaam>
      user_domain_name: <gebruikersdomein>
    region_name: <regio>
    interface: "public"
    identity_api_version: 3

Neem in de volgende stappen de waarden achter auth_url, username, project_id, user_domain_name en region_name letterlijk uit jouw bestand over. Gebruik niet de placeholders uit dit voorbeeld.

Het gedownloade bestand bevat geen wachtwoord. Gebruik bij de rclone-prompt key het wachtwoord van de gebruiker achter username.

De Object Store-remote configureren

Stap 1

Open een terminal, PowerShell of de opdrachtprompt en start de interactieve configuratie:

rclone config

Rclone bewaart de remote in het lokale configuratiebestand van rclone. Je hoeft deze configuratie daarom maar één keer per computer en gebruiker uit te voeren.

Stap 2

Kies n voor een nieuwe remote. Gebruik daarna deze naam:

objectstore

Typ bij Storage de waarde swift. Gebruik de tekstwaarde in plaats van het getoonde nummer, omdat het nummer tussen rclone-versies kan veranderen.

Stap 3

Vul de prompts als volgt in. ‘Enter’ betekent dat je het veld leeg laat en alleen op Enter drukt.

Stap 4

Kies n bij ‘Edit advanced config?’. Controleer de getoonde samenvatting en kies daarna y bij ‘Keep this "objectstore" remote?’. Kies tot slot q om de configuratie af te sluiten.

De configuratie controleren

Gebruik altijd een dubbele punt achter de remotenaam. Bekijk de beschikbare Swift-containers:

rclone lsd objectstore:

De verbinding werkt wanneer rclone de containers toont of de opdracht zonder foutmelding afsluit als het project nog geen containers bevat.

Bekijk de objecten in een bestaande container door <containernaam> te vervangen door de werkelijke containernaam:

rclone ls objectstore:<containernaam>

Een testcontainer aanmaken

Maak een lege testcontainer aan:

rclone mkdir objectstore:rclone-test

Controleer of rclone-test in het containeroverzicht staat:

rclone lsd objectstore:

Zie je de container, dan werken zowel de authenticatie als de schrijfrechten voor het Object Store-project.

De testcontainer verwijderen

Verwijder de lege testcontainer:

rclone rmdir objectstore:rclone-test

Controleer daarna opnieuw het containeroverzicht:

rclone lsd objectstore:

De container rclone-test hoort niet meer in de uitvoer te staan. rclone rmdir verwijdert alleen een lege container en voorkomt daardoor dat je onbedoeld objecten verwijdert.

Veelvoorkomende fouten

• Rclone behandelt de remotenaam als lokale map: controleer of het commando objectstore: met een dubbele punt bevat. Zonder dubbele punt verwijst rclone naar een lokale map.
• HTTP 404 tijdens authenticatie: controleer of de waarde bij auth eindigt op /v3. De download uit Horizon kan een basis-URL zonder versienummer bevatten.
• Response didn't have storage url and auth token: de authenticatie kan zijn gelukt, maar de geselecteerde projectservicecatalogus bevat geen Swift-endpoint. Controleer bovenaan Horizon of je het juiste Object Store-project hebt geselecteerd en of Swift voor dat project actief is.
• Geen verbinding na een gewijzigde regio: neem region_name opnieuw en exact over uit de actuele clouds.yaml van hetzelfde project.
• Authenticatiefout na het invullen van de projectgegevens: gebruik project_id bij tenant_id en laat tenant leeg. Controleer ook de gebruikersnaam, het wachtwoord en user_domain_name.
• rclone wordt niet herkend in Windows: sluit PowerShell of de opdrachtprompt na het aanpassen van Path en open een nieuw venster. Controleer ook of de map met rclone.exe exact in Path staat.
• De testcontainer kan niet worden verwijderd: rclone rmdir verwijdert alleen een lege container. Verwijder of verplaats eerst eventuele testobjecten en voer de opdracht daarna opnieuw uit.

Samenvatting

Je hebt rclone geïnstalleerd en met de actuele gegevens uit clouds.yaml gekoppeld aan de Swift-API van je Object Store-project. Daarna heb je de verbinding gecontroleerd, een lege testcontainer aangemaakt en deze weer verwijderd.

Meer achtergrond over de gebruikte opslagtermen lees je in Wat is een Object Store S3-Bucket/Container?.