Utiliser la console Nextcloud ''occ''

L'utilisateur Nextcloud’s command-line

La commande occ de Nextcloud (origine de "ownCloud Console") est l'interface de ligne de commande de Nextcloud. Vous pouvez effectuer de nombreuses opérations courantes sur le serveur avec occ, comme l'installation et la mise à niveau de Nextcloud, la gestion des utilisateurs, le scan de fichiers, du cryptage, des mots de passe, des paramètres LDAP, etc...

Trouver le bon utilisateur 

Pour utiliser l'interface ''occ'' il faut être préalablement connecté avec l'utilisateur disposant des droits. Pour connaître l'utilisateur qui possède les droits il faut se connecter dans le conteneur. 

Se connecter dans le conteneur

sudo docker exec -it nextcloud bash

Trouver l'interface occ

Une fois dans le conteneur, rechercher l'emplacement du fichier ''occ''. Il est généralement à l'emplacement suivant : /var/www/nextcloud/occ dans notre cas il est dans /var/www/html/occ .

Pour exécuter le script ''occ'' il faut utiliser php par conséquent il faudra effectuer la commande suivante :

root@980bf10821234:/var/www/html# php occ
Console has to be executed with the user that owns the file config/config.php
Current user id: 0
Owner id of config.php: 33
Try adding 'sudo -u #33' to the beginning of the command (without the single quotes)
If running with 'docker exec' try adding the option '-u 33' to the docker command (without the single quotes)

La commande nous retourne une erreur pour nous informer que nous essayons d'exécuter le script avec le mauvais utilisateur. Elle nous informe aussi que le bon utilisateur est l'utilisateur 33. 

Pour lister les utilisateurs existants dans le conteneur on peux utiliser la même commande que pour un Linux. 

cat /etc/passwd Ce qui nous retourne les lignes suivantes :

root:x:0:0:root:/root:/bin/bash
daemon:x:1:1:daemon:/usr/sbin:/usr/sbin/nologin
bin:x:2:2:bin:/bin:/usr/sbin/nologin
..
www-data:x:33:33:www-data:/var/www:/usr/sbin/nologin
...

Dans notre cas l'utilisateur 33 est www-data. Maintenant que nous connaissons le bon utilisateur, nous devons sortir de conteneur et se reconnecter en tant que l'utilisateur www-data. 

Se connecter en tant que

Pour se connecter en tant que dans un conteneur, il suffit de rajouter l'option -u user_id se qui donne la commande suivante :

sudo docker exec -it -u 33 nextcloud bash

Utiliser occ

Maintenant que nous sommes connecté avec le bon utilisateur nous pouvons exécuter l'invite de commande Nextcloud. 

www-data@980bf1081234:~/html$ php occ
Nextcloud 23.0.0

Usage:
  command [options] [arguments]

Options:
  -h, --help            Display this help message
  -q, --quiet           Do not output any message
  -V, --version         Display this application version
      --ansi            Force ANSI output
      --no-ansi         Disable ANSI output
  -n, --no-interaction  Do not ask any interactive question
      --no-warnings     Skip global warnings, show command output only
  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Available commands:
...

Le scan de fichier

Scanner des nouveaux fichiers 

Il peut être intéressant de transférer des fichiers d'un serveur à l'autre directement dans l'emplacement de stockage de Nextcloud sans passer par l'interface d'upload. Dans ce cas il faudra réaliser un scan de fichiers pour les voir apparaître sur Nextcloud une fois le transfert terminé. 

Se connecter en tant que 

Pour réaliser le scan de fichier il faut être connecté avec l'utilisateur disposant des droits sur l'invite de commande Nextcloud. Si vous ne savez pas le faire, voir le tuto suivant : L'utilisateur Nextcloud’s command-line

Utiliser Nextcloud command-line 

Pour avoir la liste des processus existant vous avez tout simplement besoins d'exécuter occ : php occ

Dans notre cas c'est l'un des scripts suivant qui nous intéresse : 

 files
  files:cleanup                          cleanup filecache
  files:recommendations:recommend
  files:repair-tree                      Try and repair malformed filesystem tree structures
  files:scan                             rescan filesystem
  files:scan-app-data                    rescan the AppData folder
  files:transfer-ownership

Sur internet ils indiquent d'utiliser le script files:scan avec l'option --user, or cette option n'existe plus. Démonstration : 

www-data@980bf1081234:~/html$ php occ files:scan --user


  The "--user" option does not exist.


files:scan [--output [OUTPUT]] [-p|--path PATH] [--all] [--unscanned] [--shallow] [--home-only] [--] [<user_id>...]

Par conséquent il faudra utiliser l'une des options indiqué dans le message d'erreur. Dans notre cas nous allons utiliser l'option [<user_id>...]. 

Pour connaître la liste des utilisateurs dans Nextcloud il faut exécuter le script occ suivant : 

www-data@980bf1081234:~/html$ php occ user:list
  - admin: admin
  - john: john
  - guest: Invité

Scanner les fichiers

Une fois que nous sommes connecté avec le bon utilisateur et que nous connaissons l'id utilisateur sur lequel nous allons exécuter le script il suffit d'effectuer la commande suivante : 

www-data@980bf1081234:~/html$ php occ files:scan john
Starting scan for user 1 out of 1 (john)
+---------+-------+--------------+
| Folders | Files | Elapsed time |
+---------+-------+--------------+
| 13      | 30    | 00:00:01     |
+---------+-------+--------------+

Maintenant tous les fichiers rajouter via un transfert seront visibles sur Nextcloud. 

Rajouter une extension dans le conteneur Nextcloud

MediaDC

source : https://github.com/andrey18106/mediadc-docker-example

Les commandes pour installer les packages nécessaires : 

apt update
apt upgrade
apt install ffmpeg
apt install imagemagick
apt install supervisor
apt install python3-pip