Shell CI

Catalogue des nœuds Actions

Sur cette page

Exécute des commandes shell dans le workspace du run

Utilisation et spécificités

Exécute les commandes dans le workspace du run via la cible d’exécution choisie. Créez ou sélectionnez d’abord le workspace à utiliser.

Type technique : ci_shell. Runtime : docker.

Identifiants et prérequis

Aucun identifiant externe dédié n’est défini par ce nœud. Les sources distantes ou la cible d’exécution peuvent néanmoins nécessiter leurs propres accès.

Consultez le guide des identifiants si une source distante ou une cible d’exécution nécessite un accès.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`commands`	`array`	`["echo \"hello\""]`	-; min 1
`workingDir`	`string`	-	-
`image`	`string`	-	-
`secretCredentialIds`	`array`	`[]`	-
`secretFiles`	`array`	`[]`	-; max 20
`secretFiles[].path`	`string`	-	-; min 1, max 1024
`secretFiles[].content`	`string`	-	-; max 1048576
`workspaceSource`	`union`	`{"kind":"upstream"}`	-
`workspaceSource.kind`	`literal`	`"upstream"`	`upstream`, `node`
`workspaceSource.key`	`string`	-	-; min 1
`executionTarget`	`union`	`{"kind":"host"}`	-
`executionTarget.kind`	`literal`	`"host"`	`host`, `remote_server`, `kube`, `swarm`
`executionTarget.serverId`	`string`	-	-; min 1
`executionTarget.provider`	`enum`	-	`aws`, `gcp`, `scaleway`, `ovh`, `azure`, `digitalocean`, `hetzner`
`executionTarget.clusterId`	`string`	-	-; min 1
`executionTarget.namespace`	`string`	-	-

Aide de configuration

commands Commandes: Ex. bun install && bun run check
workingDir Répertoire de travail (relatif): Sous-dossier du workspace où exécuter les commandes (ex. apps/backend).
image Image de conteneur (shell): Image contenant les outils de vos commandes. Par défaut : oven/bun:1 pour Shell et Vérification ; node:22-bookworm pour Release.
secretCredentialIds Secrets: Connexions Secrets injectées comme variables d'environnement du script (process.env, os.environ…). Le fichier qui les porte est effacé dès le démarrage du conteneur.

Exemples

Ex. bun install && bun run check
Par défaut : checkout amont le plus proche sur cette branche

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "commands": [
    "echo \"hello\""
  ],
  "workspaceSource": {
    "kind": "upstream"
  },
  "executionTarget": {
    "kind": "host"
  }
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.