CLI

vercel link

Reliez un dossier local à un projet.

Les autres commandes savent ensuite à quel projet s'adresser.

Usage

Terminal
vercel --api https://api.host.hgdc.ch link

# Sans question, avec le nom du dossier
vercel --api https://api.host.hgdc.ch link --yes

La liaison est écrite dans .vercel/project.json, qui contient l'identifiant de l'équipe (orgId) et celui du projet (projectId) :

.vercel/project.json
{
  "orgId": "k57…",
  "projectId": "j97…"
}

Création du projet

Vous n'avez pas besoin de créer le projet dans la console. Le premier vercel link ou vercel deploy sur un nom inconnu le crée, sous le nom du dossier.

En CI, sans dossier .vercel

Dans une CI, le dossier .vercel n'existe pas. Donnez les deux identifiants par variables d'environnement, avec la clé :

Terminal
export VERCEL_ORG_ID=k57…
export VERCEL_PROJECT_ID=j97…
export VERCEL_TOKEN=ah_…
vercel --api https://api.host.hgdc.ch deploy --prod --yes

Options

Options de la commande

--yesboolean
Relie le dossier sans rien demander, et crée le projet s'il n'existe pas.
--projectstring
Nom du projet à relier, si ce n'est pas le nom du dossier.
--cwdchemin
Dossier à relier, si ce n'est pas le dossier courant.

Options globales

Ces deux options s'ajoutent à chaque commande. Elles sont détaillées dans Configurer la CLI.

Options

--apiURLrequis
Adresse de l'API de SmartFlow Host : https://api.host.hgdc.ch.
--tokenstringrequis
Clé d'API, qui commence par ah_. Elle peut aussi venir de la variable VERCEL_TOKEN.

Délier un dossier

Supprimez le dossier .vercel. Le prochain déploiement vous redemandera le projet.