# KNIFE: Sous commande knife upload

{{INLINETOC}}

Pour télécharger des données sur le serveur Chef à partir du répertoire de travail actuel du chef-repo. Les types de données suivants peuvent être téléchargés avec cette sous-commande:

  * Livres de cuisine
  * Sacs de données
  * Rôles stockés sous forme de données JSON
  * Environnements stockés sous forme de données JSON 

(Les rôles et les environnements stockés sous forme de données Ruby ne seront pas téléchargés.) Cette sous-commande est souvent utilisée en conjonction avec knife diff , qui peut être utilisée pour voir exactement quels changements seront téléchargés, puis knife download , qui fait l'inverse du knife upload.

## Syntaxe

Cette sous-commande a la syntaxe suivante:

```
knife upload [PATTERN...] (options)
```

## Options 

Cette sous-commande comporte les options suivantes:

^ Option ^ Description ^ Valeur par défaut ^
| --chef-repo-path PATH | Le chemin du chef-repo. Ce paramètre remplacera le chemin par défaut du chef-repo. | même valeur que celle spécifiée par chef\_repo\_path dans client.rb. |
| --concurrency | Le nombre de connexions simultanées autorisées. | 10 |
| --[no-]diff | Télécharger uniquement les fichiers nouveaux et modifiés. Définir sur **false** pour télécharger tous les fichiers. | true |
| --[no-]force | Utiliser **--force** pour télécharger des rôles, des livres de recettes, etc. même si le fichier du répertoire est identique (par défaut, aucun POST ou PUT n'est exécuté à moins qu'un changement réel ne soit effectué). | --no-force |
| --[no-]freeze | Exiger que les modifications apportées à un livre de recettes soient incluses dans une nouvelle version. Seule l'option --force peut remplacer ce paramètre. | false |
|-n , --dry-run | Ne rien faire et imprimer uniquement les résultats. | false |
| --[no-]purge | Utiliser --purge pour supprimer des rôles, des livres de recettes, etc. du serveur Chef si leurs fichiers correspondants n'existent pas dans le chef-repo. Par défaut, ces objets sont laissés seuls et NON purgés. | --no-purge |
| --[no-]recurse | Utiliser **--no-recurse** pour désactiver le téléchargement d'un répertoire. | --recurse |
| --repo-mode MODE | La mise en page du chef-repo local. Valeurs possibles: **static**, **everything** ou **hosted\_everything**. Utiliser **static** pour les rôles, les environnements, les livres de recettes et les poches de données uniquement. Par défaut, everything et hosted\_everything sont sélectionnés dynamiquement en fonction du type de serveur. | everything/hosted\_everything |

## Exemples

Les exemples suivants montrent comment utiliser cette sous-commande knife:

### Télécharger l'intégralité du chef-repo

Se placer au niveau supérieur du chef repo et entrer:

```
knife upload .
```

ou de n'importe où dans le chef repo, entrer:

```
knife upload /
```

pour télécharger tous les livres de recettes et les sacs de données, ainsi que tous les rôles et environnements stockés sous forme de données JSON. (Les rôles et les environnements stockés sous forme de données Ruby ne seront pas téléchargés.)

### Télécharger le répertoire /cookbooks

Se placer au  niveau supérieur du chef repo et entrez:

```
knife upload cookbooks
```

ou de n'importe où dans le chef repo, entrer:

```
knife upload /cookbooks
```

### Télécharger le répertoire /environments

Se placer au  niveau supérieur du chef repo et entrez:

```
knife upload environments
```

ou de n'importe où dans le chef repo, entrez:

```
knife upload /environments
```

pour télécharger tous les environnements stockés sous forme de données JSON. (Les environnements stockés sous forme de données Ruby ne seront pas téléchargés.)

### Télécharger un seul environnement

Se placer au niveau supérieur du chef repo et entrer:

```
knife upload environments/production.json
```

ou à partir du répertoire environments/ , entrer:

```
knife upload production.json
```

### Télécharger le répertoire /roles

Se placer au niveau supérieur du chef repo et entrer:

```
knife upload roles
```

ou de n'importe où dans le chef repo, entrer:

```
knife upload /roles
```

pour télécharger tous les rôles stockés sous forme de données JSON. (Les rôles stockés sous forme de données Ruby ne seront pas téléchargés.)

### Télécharger des cookbooks et des rôles

Se placer au  niveau supérieur du chef repo et entrer:

```
knife upload cookbooks/apache\* roles/webserver.json
```

### Utiliser la sortie de knife deps dans la commande knife upload

```
knife upload `knife deps nodes/*.json`
```