Package d’applications JET
Une fois le développement de l’application terminé, écrivez le fichier JSON (JavaScript Object Notation) décrivant le contenu à construire et à packager l’application avant de le déployer sur l’équipement. JSON est un format léger d’échange de données. Il est facile pour les humains de lire et d’écrire, et aussi pour les machines d’analyser et de générer. Pour plus de détails, voir https://www.json.org.
Les fichiers JSON sont constitués d’un ensemble d’attributs inclus dans un ensemble d’accolades. Les attributs utilisent deux structures :
Une collection de paires clé-valeur.
Liste ordonnée de valeurs.
Lisez plus en détail chacun des attributs contenus dans le format JSON pour le packaging des applications.
Attributs de la section principale
Le bloc supérieur du fichier JSON est la section principale du fichier. Il se compose d’attributs obligatoires et facultatifs.
Attributs obligatoires
Le tableau 1 décrit les attributs obligatoires que doivent avoir tous les fichiers JSON pour le packaging d’applications dans la section principale. Voici un exemple de fichier JSON d’application simple contenant uniquement les attributs obligatoires :
{
"app-name": "testcapp",
"app-path": "bin/test-c-app",
"language": "c",
"app-type": "standalone",
"sign": "yes",
"os-type": "bsd10",
"target-arch": "i386",
"description": "C Test Application",
"srcs": {
"bin/test-c-app": ["test_app.c"]
}
}
Attribut |
Description |
Exemples de valeurs |
|---|---|---|
|
Spécifiez le nom de l’application. |
|
|
Spécifiez le chemin vers le répertoire d’implémentation de l’application. Tous les chemins doivent être relatifs au sandbox src. |
|
|
Spécifiez la langue utilisée pour développer l’application. |
|
|
Il s’agit d’une liste d’attributs. Spécifiez le nom de fichier ou les noms du script principal ou des scripts qui s’exécutent sur l’équipement (ne spécifiez pas le module ici). Les fichiers de script principaux seront déployés sous le chemin /var/db/scripts/jet sur l’équipement. |
|
|
Spécifiez si une application doit être un programme autonome ou un démon. |
|
|
Indiquez si la demande doit être signée ou non. |
|
|
Spécifiez si l’application doit être déployée sur l’ancien système d’exploitation Junos (bsd6) ou Junos OS avec FreeBSD (bsd10) mis à niveau. |
|
|
Spécifiez l’architecture cible sur laquelle l’application doit être déployée. |
|
|
Écrivez une brève description (une ligne) de l’application. Cela sera affiché dans la sortie de la |
|
Attributs optionnels
Le tableau 2 décrit les attributs facultatifs que vous pouvez inclure dans la section principale du fichier JSON pour le packaging de l’application. Voici un exemple de section principale avec des attributs obligatoires et facultatifs :
{
"app-name": "sample_pyapp",
"app-path": "python/sample_pyapp",
"language": "python",
"main-scripts": ["foo.py", "bar.py"],
"app-type": "standalone",
"sign": "no",
"os-type": "bsd6",
"target-arch": "i386",
"description": "Simple Python test app",
"c-compiler-flags": "-DFOO -DBAR",
"c++-compiler-flags": "-DAPP_CHECK –DSOMETHING_ON",
"linker-flags": "-lstdc++ -lfoo" }
Attribut |
Description |
Exemples de valeurs |
|---|---|---|
|
Spécifiez la liste des indicateurs du compiler C, le cas échéant. Les indicateurs de compilation peuvent être définis pour la section principale, les bibliothèques dépendantes (dep-libs) ou les modules Python dépendants (dep-py-modules). |
|
|
Spécifiez la liste des indicateurs de compilation C++, le cas échéant. Les indicateurs de compilation peuvent être définis pour la section principale, les bibliothèques dépendantes (dep-libs) ou les modules Python dépendants (dep-py-modules). |
|
|
Spécifiez la liste des indicateurs de linker, le cas échéant. Utilisez ces indicateurs pour spécifier des bibliothèques supplémentaires à relier ou des indicateurs supplémentaires spécifiques à une liaison requis lors de la liaison. Vous pouvez définir des indicateurs spécifiques à chaque linker dans la section principale ou dans la section dep-py-modules. |
|
Attributs source
Le tableau 3 présente deux attributs source que vous pouvez utiliser pour spécifier les fichiers source pour le package d’application. Voici un exemple d’application Python avec des fichiers de module supplémentaires à déployer, ainsi que le fichier de script principal :
{
"app-name": "sample_pyapp",
"app-path": "python/sample_pyapp",
"language": "python",
"main-scripts": ["foo.py", "bar.py"],
"app-type": "standalone",
"sign": "no",
"os-type": "bsd6",
"target-arch": "i386",
"description": "Simple Python test app",
"srcs": {
"python/sample_pyapp": ["a.py", "b.py"],
"python/sample_pyapp/temp": ["temp1.py", "temp2.py"]
},
"extn-srcs": {
"python/sample_pyapp": ["foo.c", "bar.c"],
"python/sample_pyapp/temp": ["1.cpp", "2.cpp"]
}
}
Attribut |
Description |
Exemples de valeurs |
|---|---|---|
|
Spécifiez la liste des fichiers source supplémentaires. Pour les applications Python, ces fichiers source sont les fichiers de module supplémentaires. Pour les applications C ou C++, ces fichiers source sont les fichiers source à compiler pour générer des lib/binaires. Chaque entrée doit être une paire clé-valeur, où la clé est le chemin des fichiers source et la valeur est un tableau de noms de fichiers source. |
"srcs": {
"python/sample_pyapp": ["a.py", "b.py"],
"python/sample_pyapp/temp": ["temp1.py", "temp2.py"]
}
|
|
Cette section s’applique uniquement à Python. Spécifiez la liste des fichiers de modules C ou C++ à compiler. Chaque entrée doit être une paire clé-valeur, où la clé est le chemin des fichiers source et la valeur est un tableau de noms de fichiers source. |
"extn-srcs": {
"python/sample_pyapp": ["foo.c", "bar.c"],
"python/sample_pyapp/temp": ["1.cpp", "2.cpp"]
}
|
Bibliothèques dépendantes
Vous devez compiler toutes les bibliothèques dépendantes disponibles dans la section Bibliothèques dépendantes (dep-libs). La bibliothèque générée à partir de ce code JSON est intégrée à l’application. La dep-libs section est un tableau de plusieurs dépendances de bibliothèque, chacune composée des paires clé-nom suivantes :
"lib-name"est le nom de la bibliothèque."lib-path"est le chemin du code source de la bibliothèque dans le sandbox de développement."srcs"est une paire clé-valeur dans laquelle le chemin est la clé et sa valeur est une liste de fichiers source.
Voici un exemple d’attribut dep-libs :
"dep-libs": [
{
"lib-name": "xyz",
"lib-path": "lib/xyz",
"srcs": {
"lib/xyz": ["foo.c", "bar.c"]
}
}
]
Modules Python dépendants
L’attribut modules Python dépendants (dep-py-modules) est utilisé uniquement pour les applications Python. Cet attribut contient tous les modules Python dépendants qui doivent être compilés et emballés avec l’application. L’attribut dep-py-modules est un tableau dans lequel vous pouvez spécifier plusieurs dépendances de module Python. Chaque dépendance est composée des objets suivants :
"py-module-name"est le nom du module Python."py-module-path"est le chemin du code source du module Python dans le sandbox de développement."srcs"est une paire clé-valeur dans laquelle le chemin est la clé et sa valeur est une liste de fichiers source."extn-srcs"est une paire clé-valeur dans laquelle le chemin est la clé et sa valeur est une liste de fichiers source d’extension Python.
Voici un exemple d’attribut dep-py-modules :
"dep-py-modules": [
{
"py-module-name": "module_a",
"py-module-path": "python/module_a",
"srcs": {
"python/module_a": ["foo.py", "bar.py"]
},
"extn-srcs": {
"python/module_a": ["foo.c", "bar.c"],
"python/module_a/sub_mod": ["lmn.cpp"]
}
}
]