---
title: Publier une feature
slug: oip-next/HSfH-publier-une-feature
icon: {"lucideIcon":"📘"}
createdAt: 2026-06-11T08:32:03.000Z
---

# Publier une feature

La commande features upload permet de publier ou de mettre à jour une feature dans le registre OIP API.

Elle est destinée aux équipes qui développent et maintiennent des features OIP.

## Utilisation

:::BlockQuote
oip-tools features upload \<feature>
:::

## Paramètre

| Paramètre  | Description                                   | Obligatoire |
| ---------- | --------------------------------------------- | ----------- |
| \<feature> | Nom de la feature à publier ou mettre à jour. | Oui         |

## Formats d’entrée supportés

La commande accepte plusieurs formats pour identifier la feature :

:::BlockQuote
oip-tools features upload document
:::

:::BlockQuote
oip-tools features upload oip-features-document
:::

:::BlockQuote
oip-tools features upload @org/oip-features-document
:::

## Convention locale attendue

La feature doit être présente localement dans le dossier suivant :

:::BlockQuote
features/\<nom>
:::

Exemple :

:::BlockQuote
features/document
:::

## Fichiers attendus

La commande s’appuie sur les fichiers de configuration de la feature.

Les fichiers suivants sont attendus :

| Fichier      | Description                                                                      |
| ------------ | -------------------------------------------------------------------------------- |
| manifest.yml | Décrit la feature, ses métadonnées, ses dépendances ou les services nécessaires. |
| package.json | Décrit le package associé à la feature et ses dépendances.                       |

## Fonctionnement général

La commande lit les informations de la feature, prépare les éléments nécessaires, puis publie ou met à jour la feature dans le registre OIP API.

Selon la configuration de la feature, elle peut notamment prendre en compte :

- le nom de la feature ;
- sa version ;
- sa description ;
- ses dépendances ;
- les services nécessaires à son fonctionnement ;
- les métadonnées déclarées dans le manifest.yml.

## Remarques

La commande nécessite un accès réseau à l’OIP API.

Les variables d’environnement nécessaires à l’authentification doivent être correctement renseignées.

Avant de publier une feature, il est recommandé de vérifier la cohérence du manifest.yml et du package.json.
