# Déployer un service

> Faites tourner un service de l'architecture dans un environnement, avec une image construite et un nombre de réplicas.

Déployer un service crée son instance dans un environnement et y démarre l'image de votre choix. C'est l'étape qui fait passer un service de l'architecture à un conteneur en cours d'exécution.

## Avant de commencer

- Le service existe dans l'architecture : voir [Créer un service](/v1.0/services/creer-un-service).
- Au moins un build du service a réussi : voir [Lancer un build](/v1.0/builds-et-deploiements/lancer-un-build). Sans build, la liste des images est vide.
- Les variables attendues du service ont une valeur dans l'environnement, ou une valeur par défaut : voir [Variables et secrets](/v1.0/variables-et-secrets). Vous pourrez aussi les relier juste après le déploiement.

## Déployer le service

::::steps
### Ouvrir le formulaire

Dans **Environnements**, ouvrez l'environnement, puis l'onglet **Services**, puis cliquez sur **Déployer un service**.

### Choisir le service et l'image

Dans la carte **Service à déployer** :

1. Dans **Définition de service**, choisissez le service. Seuls les services pas encore déployés dans cet environnement sont proposés.
2. Dans **Image à déployer**, choisissez l'image. Chaque image est désignée par son tag et la branche dont elle provient ; la plus récente est en tête.

### Régler l'instance

Dans la carte **Configuration de l'instance**, saisissez le **Nombre de réplicas**, par exemple `1` en développement et `2` en production.

Optionnel : dans la carte **Ressources (optionnel)**, saisissez **CPU Request**, **Memory Request**, **CPU Limit** ou **Memory Limit** pour surcharger les valeurs de la définition. Les champs laissés vides reprennent les valeurs par défaut, affichées en grisé.

### Déployer

Cliquez sur **Déployer le service**.

Résultat : le message « Service instancié » s'affiche et la liste **Instances de services** montre le service avec le statut **En attente**, puis **Provisionnement…**, puis **Provisionné** quand ses conteneurs sont démarrés et en bonne santé.
::::

La plateforme met aussi à jour les variables calculées des autres services de l'environnement, qui peuvent ainsi joindre le nouveau service. Les variables du service lui-même se relient dans l'onglet **Configuration du service** de l'instance : voir [Variables et secrets](/v1.0/variables-et-secrets).

## Vérifier le résultat

1. Dans la liste **Instances de services**, cliquez sur le service.
2. Dans l'onglet **Vue générale**, la carte **Déploiement actuel** affiche le tag de l'image.
3. L'onglet **Déploiements** contient la ligne du premier déploiement au statut **Réussi**.
4. L'onglet **Logs** montre le démarrage de votre application.

## Dépannage

- La liste **Image à déployer** affiche « Aucun build disponible pour ce service. Lancez un build depuis l'onglet Builds avant de déployer. » : lancez un build, attendez son succès, puis recommencez.
- « Tous les services sont déployés » : chaque service de l'architecture a déjà une instance dans cet environnement. Pour changer d'image, voir [Déployer une image](/v1.0/builds-et-deploiements/deployer-une-image).
- Le statut reste **Provisionnement…** : voir [Résoudre les problèmes de services](/v1.0/services/depannage#le-service-reste-en-provisionnement).

## Voir aussi

- [Déployer une image](/v1.0/builds-et-deploiements/deployer-une-image)
- [Dimensionner un service](/v1.0/services/dimensionner-un-service)
- [Domaines et URLs](/v1.0/domaines-et-urls) : exposer le service sur une URL publique
