# Les projets

> Un projet regroupe des services, leur donne un réseau privé et une dépense commune. Tu peux y inviter des membres, avec leurs droits.

Source : https://docs.arkya.gg/demarrer/projets

## À quoi sert un projet

Un projet, c’est un dossier de services : le site, sa base et son bot, par exemple. L’espace client le montre sous forme de canevas, avec un panneau par service.

Ton compte en a toujours un, créé à l’inscription. Celui-là ne se supprime pas. Les autres se suppriment une fois vides.

## Le réseau privé

Les applications et les bases d’un même projet se joignent par une adresse interne, sans passer par Internet. Tu n’as pas à la retenir : dans les variables d’une application, `${boutique-db.HOST}` est remplacé par l’adresse de la base `boutique-db`. Voir [Variables et références](https://docs.arkya.gg/applications/variables).

Un service d’un autre projet ne les voit pas. C’est la règle qui permet de séparer la production d’un essai, ou deux clients d’une agence.

Les serveurs de jeu et les VPS ne sont pas sur ce réseau. Un serveur de jeu joint sa base offerte par une adresse réservée aux machines de jeu : voir [La base offerte](https://docs.arkya.gg/serveurs-de-jeu/base-offerte).

## Créer et ranger

Depuis l’espace client, crée un projet puis commande tes services dedans. Depuis le terminal :

```bash
ark project create Production
ark project attach mon-api Production
ark project show Production
```

`ark project show` affiche la dépense de chaque service sur les 30 derniers jours. L’espace client la détaille dans l’onglet **Consommation** du projet.

> **Bon à savoir**
>
> Une base de données ne change pas de projet : son réseau en dépend. Pour déplacer des données, crée une base dans le nouveau projet et importe-les. Voir [Importer un fichier SQL](https://docs.arkya.gg/bases-de-donnees/import-sql).

## Inviter des membres

Dans l’onglet **Membres** du projet, invite quelqu’un par son e-mail. Il lui faut un compte Arkya. L’invitation vaut 7 jours, et un projet accueille jusqu’à 20 membres.

| Rôle | Ce qu’il permet |
| --- | --- |
| Lecteur | voir les services et lire leurs journaux |
| Opérateur | en plus : démarrer, arrêter, ouvrir la console |
| Développeur | en plus : fichiers, sauvegardes, planifications, démarrage, bases, déploiements |
| Admin | tout, réglages et dépense compris |
| Personnalisé | les droits que tu coches, sur tout le projet ou sur certains services |

Le propriétaire reste seul à payer. Lui seul commande, change la taille d’un service, le supprime, le déplace, le réinstalle et gère les membres.

## Transférer un service à un autre compte

Depuis les réglages d’un service, le propriétaire peut l’envoyer à un autre compte Arkya, par son e-mail. Le destinataire a 7 jours pour accepter dans **Transferts**. Une fois accepté, le service et sa facturation passent chez lui.

Le service part avec ses sauvegardes et ses sous-domaines. Le destinataire doit avoir un solde qui couvre une journée du service.

- Un transfert est refusé quand ton solde est négatif, ou pour un service suspendu par l’équipe.
- Un serveur gratuit ne se transfère pas. Une base offerte suit son serveur de jeu.
- Une base transférée est coupée un court instant et change de mots de passe.