> For the complete documentation index, see [llms.txt](https://cleyrop.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cleyrop.gitbook.io/docs/v4.7/la-fabrique/gerer-les-images.md).

# Gérer les images

Créez et buildez des images Docker depuis vos repositories Git pour alimenter vos Apps et Tools.

Une image Docker est une version exécutable de votre code, buildée depuis un [dépôt Git](/docs/v4.7/la-fabrique/depots-git.md) (interne ou externe) et stockée dans le registre interne Cleyrop.

***

## Créer et builder une image

1. Depuis la fiche de votre App, accédez à l'onglet **Registre interne**
2. Cliquez sur **Créer une image**
3. Dans la section **Repository**, sélectionnez le dépôt Git source de l'image ou ajoutez-en un, interne ou externe : voir [Dépôts Git](/docs/v4.7/la-fabrique/depots-git.md#utiliser-un-depot-dans-une-app)
4. Dans la section **Configuration** :
   * Renseignez le **chemin vers le Dockerfile** (ex : `/Dockerfile`)
   * Choisissez quelle référence sera prise pour build l'image : une **branche** ou un **tag** Git.
   * Choisissez la branche ou le tag en question depuis le menu déroulant.
5. Dans la section **Image** :
   * Le nom de version est pré-rempli avec le nom de la branche/tag
   * Vous pouvez le modifier si nécessaire
6. Cliquez sur **Créer**

{% hint style="info" %}
Réutiliser un nom de version existant **écrase** l'image précédente. Un message de confirmation s'affiche avant l'opération.
{% endhint %}

Le build est lancé. L'image peut avoir par les états suivants :

| Statut        | Description                                                         |
| ------------- | ------------------------------------------------------------------- |
| **En cours**  | Build en cours d'exécution                                          |
| **Valide**    | Build réussi, image disponible dans le registre                     |
| **En erreur** | Premier build échoué, aucune image disponible                       |
| **Attention** | Rebuild échoué, mais une version précédente valide reste disponible |

## Actions disponibles sur une image

* **Rebuild** : relancer un build sur la même branche/tag (récupère le dernier commit)
* **Supprimer** : supprimer l'image du registre
* **Copier l'URL** : copier l'URL de l'image pour l'utiliser dans une instance
* Visualiser le résultat du **Scan CVE** du build

<figure><img src="https://content.gitbook.com/content/Lve2h8CdCFZ7rIwwaoUU/blobs/NIuhir37Gxrt6dE4BGjd/image.png" alt="" width="563"><figcaption></figcaption></figure>

* **Consulter les logs de build :** Les logs de build sont disponibles dans la fiche détail de l'image. Ils permettent de diagnostiquer les erreurs en cas d'échec.

<figure><img src="https://content.gitbook.com/content/Lve2h8CdCFZ7rIwwaoUU/blobs/sBcbP7q6NCgZo4mqQZg3/image.png" alt="" width="563"><figcaption></figcaption></figure>

### Bonnes pratiques pour le build d'images

* **Utilisez des tags Git** pour vos versions de production plutôt que des branches
* **Versionnez explicitement** vos images (ex : v1.0.0, v1.1.0) pour faciliter le rollback
* **Consultez les logs de build** en cas d'échec pour identifier rapidement les erreurs
* **Évitez d'écraser** les images en production : créez une nouvelle version plutôt que de rebuild sur le même tag