61 lines
2.4 KiB
Markdown
61 lines
2.4 KiB
Markdown
# Paramètres URL
|
|
|
|
Hackademy Linux accepte de recevoir des paramètres dans son URL, comme par exemple :
|
|
|
|
[https://linux.hackade.org/?disk=normal&autologin=user&autostart=true](https://linux.hackade.org/?disk=normal&autologin=user&autostart=true)
|
|
|
|
## Sélection de l'image
|
|
|
|
La sélection de l'image se fait avec le paramètre __disk__. Les images disponibles sont :
|
|
|
|
* core
|
|
* server
|
|
* practice (valeur par défaut)
|
|
* play
|
|
|
|
## Login automatique
|
|
|
|
Le paramètre __autoLogin__ permet de se connecter directement à la machine virtuelle au lancement. Trois options sont possibles : rien, user ou root. Par défaut l'autologin n'est pas activé.
|
|
|
|
## Démarrage automatique
|
|
|
|
Le paramètre __autostart__ permet d'indiquer si au chargement de la page, la machine virtuelle doit démarrer. Par défaut le démarrage est automatique.
|
|
|
|
## Script d'initialisation personnalisé
|
|
|
|
Le paramètre __custom_init__ permet de passer un script qui sera exécuté en root lors de la séquence de démarrage.
|
|
|
|
Le paramètre doit être encoder en base64url.
|
|
|
|
Pour encoder et décoder votre script, vous pouvez utiliser les commandes `base64url_encode` et `base64url_decode` au sein de Hackademy Linux, ou utiliser la commande suivante :
|
|
|
|
```sh
|
|
cat init_script.sh | base64 -w0 | tr '+/' '-_' | tr -d '='
|
|
```
|
|
|
|
Lorsque __custom_init__ est paramétré, __autostart__ est automatiquement désactivé et un message affiche le code dans la console avant le démarrage.
|
|
|
|
Exemple avec le script suivant:
|
|
|
|
```sh
|
|
#!/bin/sh -l
|
|
|
|
echo "Here's an example of the custom_init functionality."
|
|
opkg update && opkg install tmux
|
|
```
|
|
|
|
[https://linux.hackade.org/?custom_init=IyEvYmluL3NoCgplY2hvI...](https://linux.hackade.org/?custom_init=IyEvYmluL3NoIC1sCmVjaG8gIkhlcmUncyBhbiBleGFtcGxlIG9mIHRoZSBjdXN0b21faW5pdCBmdW5jdGlvbmFsaXR5LiIKb3BrZyB1cGRhdGUgJiYgb3BrZyBpbnN0YWxsIHRtdXgK)
|
|
|
|
## Persistance des données
|
|
|
|
Le paramètre __persistence__ permet de monter un disque dans la VM dont le contenu sera stocké dans le navigateur. Ces données persistent au redémarrage de la VM, tant que les données d'applications ne sont pas effacées de l'historique du navigateur.
|
|
|
|
Ce disque est **/dev/sdb**, il est monté automatiquement dans **/data** quand le paramètre est actif.
|
|
|
|
Pour être sûr qu'aucune donnée ne se perde, il est conseillé de synchroniser les données avant d'arrêter d'utiliser Hackademy avec la commande suivante :
|
|
```
|
|
sync
|
|
```
|
|
|
|
Par défaut le disque persistent n'est pas instancié.
|