Network/Juniper/Survival guide - Historique des versions

Admin : /* Advanced Commands Summary */

2023-02-20T18:09:21Z

Advanced Commands Summary

Admin : /* Advanced Commands Summary */

2023-02-20T18:08:47Z

Advanced Commands Summary

Admin : /* Command Summary */

2023-02-20T17:51:24Z

Command Summary

Admin : /* Command Summary */

2022-11-25T09:55:20Z

Command Summary

Admin : /* Command Summary */

2022-11-25T09:26:52Z

Command Summary

Admin : /* Command Summary */

2022-11-25T09:23:26Z

Command Summary

Admin : /* Command Summary */

2022-11-25T08:10:13Z

Command Summary

Admin le 24 novembre 2022 à 18:17

2022-11-24T18:17:36Z

Voir les modifications

Admin : Page créée avec « {{MediaWiki}}
{{FOND_BLEU|Juniper- '''Petit guide de survie''' pour un newbie ...}} = Sites Références = * [https://www.juniper.net/documentation/us/en/software/j… »

2022-11-24T18:08:14Z

Page créée avec « {{MediaWiki}} <br> {{FOND_BLEU|Juniper- '''Petit guide de survie''' pour un newbie ...}} = Sites Références = * [https://www.juniper.net/documentation/us/en/software/j… »

Nouvelle page

{{MediaWiki}}
<br>
{{FOND_BLEU|Juniper- '''Petit guide de survie''' pour un newbie ...}}

= Sites Références =
* [https://www.juniper.net/documentation/us/en/software/junos/multicast-l2/index.html The bible ....]
* [https://supportportal.juniper.net/s/knowledge?language=en_US Base de connaissance Juniper ]

= Notes =

There are several acronyms for interface types and components:

* IFD – Interface Physical Device
* IFL – Interface Logical Device
* IFF – Address Family
* IFA – Address Entry

Common interface names are:

* ge – Gigabit ethernet
* xe – 10G ethernet
* et – 100G ethernet
* ae – aggregated ethernet (LAG/etherchannel)
* vlan or irb – Logical interface based on VLAN

SFP’s can be of different speeds (eg, one may be 1G, and another may be 10G). So be aware that the interface names may change based on the SFP used.

The interface naming convention is type-x/y/z

Type is ge, xe, etc
x – FPC (aka linecard)
y – module or slot
z – port number

There are several names for management interfaces. Each platform may use different names. These include fxp0, em0, me0, and vme0. Some of these are physical, and others are virtual.

Some interfaces, such as pimd, pime, dsc, ipip, and gre, are special interfaces that are used for special purposes.

An unnumbered interface does not have an IP address. This helps conserve IP addresses.

All interfaces are configured with a unit. This contains logical interface information, like addressing. Sometimes this is used to create sub-interfaces. Physical properties (duplex, link speed, etc) are not configured in the unit.

Each unit may have one or more family. This is where the address is applied. For example, the inet family is for IPv4 addressing.

Addresses can be primary, preferred, or secondary. Primary addresses are used for locally sourced (broadcast or multicast) traffic, destined to a remote subnet. Preferred addresses are for locally sourced traffic to the local subnet.

Configuring voice ports means three main steps:

* Configuring a voice VLAN
* Configuring PoE
* Configuring LLDP-MED

Junos supports regex during configuration.

<syntaxhighlight lang="bash">
[user@demo project2]$ tree -F group_vars
group_vars/
├── db_servers/
│ ├── 3.yml
│ ├── a.yml
│ └── myvars.yml
├── lb_servers/
│ ├── 2.yml
│ ├── b.yml
│ └── something.yml
└── web_servers/
└── nothing.yml
</syntaxhighlight>

=Command Summary=

{| class="wikitable"
!colspan="3"|Juniper OS Command summary
|-
! class="wikitable" | Command
! Mode
! Description
|-
|{{CODE|show interfaces terse}}
|operational
| Get a simplified view of all interfaces on the system
|-
|{{CODE|show interfaces [extensive]}}
|operational
| Get interface statistics
|-
|{{CODE|ansible_port}}
|Port utilisé par Ansible pour se connecter à l'hôte géré. Pour le plug-in de connexion par SSH (par défaut), la valeur par défaut est '''22'''.
|-
|{{CODE|ansible_user}}
|Utilisateur dont se sert Ansible pour se connecter à l'hôte géré. Le comportement par défaut d'Ansible est de se connecter à l'hôte géré à l'aide du même nom d'utilisateur que celui qui exécute le playbook Ansible sur le noeud de contrôle.
|-
|{{CODE|ansible_become_user}}
|Une fois qu'Ansible s'est connecté à l'hôte géré, il bascule vers cet utilisateur en utilisant absible_become_method (qui est {{CODE|sudo}} par défaut). Il se peut que vous deviez vous procurer des informations d'identification d'authentification de quelque façon que ce soit.
|-
|{{CODE|ansible_python_interpreter}}
|Chemin d'accès à l'exécutable Python qu'Ansible doit utiliser sur l'hôte géré. Sur Ansible 2.8 et versions ultérieures, cette valeur par défaut est {{CODE|auto}}, qui sélectionne automatiquement un interpréteur Python sur l'hôte exécutant le playbook en fonction du système d'exploitation qu'il exécute. Ainsi, il n'est plus autant nécessaire d'utiliser ce paramètre que dans les versions antérieures d'Ansible.
|}

=== Variables utilisées lors d'exécution de playbooks ===

Lorsqu'un play est en cours d'exécution, un certain nombre de variables et de faits peuvent être utilisés pour identifier le nom de l'hôte géré actuel qui exécute une tâche :

{| class="wikitable"
!colspan="2"|Variables Ansible spécifiques à l'exécution
|-
! class="wikitable" | Variable
! Description
|-
|{{CODE|inventory_hostname}}
|Nom de l'hôte géré en cours de traitement, extrait de l'inventaire.
|-
|{{CODE|ansible_host}}
|Adresse IP ou nom d'hôte réel qui a été utilisé pour se connecter à l'hôte géré, comme indiqué
précédemment.
|-
|{{CODE|ansible_facts ['nom d'hôte']}}
|Nom court (non qualifié) de l'hôte collecté comme un fait de l'hôte géré.
|-
|{{CODE|ansible_facts ['fqdn']}}
|Nom de domaine complet de l'hôte collecté comme un fait de l'hôte géré.
|-
|{{CODE|ansible_play_hosts}}
|liste de tous les hôtes qui n'ont pas encore échoué au cours du play actuel (et qui, par conséquent, sera utilisée
pour les tâches restantes du play).|}
|}

== Penser ré-utilisabilité ! ==

Les rôles permettent de créer des playbooks simples et de réutiliser du code commun à plusieurs projets. Un '''role''' doit porter sur un objectif ou une fonction spécifique.
Idéalement, il est préférable de créer des rôles génériques configurables par le biais de variables. Ces variables sont le plus souvent définies par défaut dans le fichier YAML <code>roles/[nom_role]/default/main.yml</code>
De cette façon, un rôle disposant de son propre paramétrage et ensemble de tâches peut facillement être intégré dans un autre playbook.

Si un playbook doit modifier le contenu d'une variable définie par un rôle, il suffit :
* soit inclure un fichier de définition de variables au niveau du playbook (cf <code>[https://docs.ansible.com/ansible/latest/user_guide/playbooks_variables.html#defining-variables-in-files var_files]</code>)
* soit définir une zone tasks <code>vars:</code> qui remplace le contenu de cette variable. (cf [https://docs.ansible.com/ansible/latest/user_guide/playbooks_variables.html#variable-precedence-where-should-i-put-a-variable Ordre de précédence des variables dans un playbook ansible])

Exemple

<syntaxhighlight lang="yaml">
- hosts: webservers
vars:
apache2_config: true
apache2_default_port: 8000
roles:
ansible-apache2

</syntaxhighlight>

Ce playbook utilise le rôle <code>ansible-apache2</code> en modifiant 2 variables utilisées par ce rôle : <code>apache2_config</code> & <code>apache2_default_port</code>.

A l'éxécution de ce playbook, le service apache2 sera installé sur les serveurs <code>webservers</code> pour écouter sur le port 8000/tcp.

== Exécution centralisée des playbooks ==

Pour contrôler l'accès aux systèmes et auditer l'activité d'Ansible, il est nécessaire d'envisagez l'utilsiation d'un serveur de contrôle dédié à partir duquel tous les playbooks Ansible sont exécutés.
Les administrateurs système doivent toujours disposer de leurs propres comptes sur le système, ainsi que des informations d'identification permettant de se connecter aux hôtes gérés et d'augmenter les privilèges, si nécessaire.
Lorsqu'un administrateur système cesse de travailler sur le projet, sa clé SSH peut être supprimée du fichier <code>authorized_keys</code> de l'hôte géré et ses privilèges de commande <code>sudo</code> peuvent être révoqués, sans répercussion sur les autres administrateurs.

Ce serveur central peut avantageusement héberger les services <code>[https://www.ansible.com/products/awx-project/faq awx]</code> ou la version supportée par Red Hat <code>[https://www.ansible.com/products/tower Ansible Tower]</code>

= Tester régulièrement =

Il est bien évident qu'il faut tester les playbooks aussi bien au cours de la phase de développement que pendant l'exécution des playbooks eux-même. En effet, Ansible offre cette possibilité de s'auto-valider en définissant des tâches spécifiques permettant de vérifier une étape précédente d'un playbook.

== Test des résultats des tâches ==
Si on a besoin de confirmer la réussite d'une tâche, vérifiez le résultat de la tâche au lieu de faire confiance au code de retour du module.
Il existe plusieurs moyens de valider une tâche, en fonction du module concerné.

Exemple :

<syntaxhighlight lang="yaml">
- Start web server
service:
name: httpd
status: started
- name: Check web site from web server
uri:
url: http://{{ ansible_fqdn }}
return_content: yes
register: example_webpage
failed_when: example_webpage.status != 200
</syntaxhighlight>

== Utilisation de block/rescue pour effectuer une récupération ou une restauration ==

La directive <code>block</code> est utile pour regrouper des tâches ; lorsqu'elle est associée à la directive
<code>rescue</code>, elle est utile lorsqu'il s'agit d'effectuer une récupération après des erreurs ou des pannes.

Exemple :

<syntaxhighlight lang="yaml">
- block:
- name: Check web site from web server
uri:
url: http://{{ ansible_fqdn }}
return_content: yes
register: example_webpage
failed_when: example_webpage.status != 200
rescue:
- name: Restart web server
service:
name: httpd
status: restarted
</syntaxhighlight>

== Outils de test ==

* <code>ansible-playbook --syntax-check</code> : pour vérifier la syntaxe d'un playbook (sans l'exécuter)
* <code>ansible-playbook --check</code> : Exécute un playbook en mode "vérification"
{{NOTE
|contenu=
Cette vérification ne garantit pas une précision parfaite, étant donné que le playbook peut avoir besoin d'exécuter réellement certaines tâches avant que les tâches ultérieures du playbook ne fonctionnent correctement. Certaines tâches peuvent être marquées avec la directive check_mode: no. Ces tâches s'exécutent même en mode vérification.
}}

{{NOTE
|contenu=
Il existe d'autres outils. Par exemple :
L'outil <code>ansible-lint</code> analyse un playbook et recherche les problèmes éventuels. Tous les problèmes signalés n'interrompront pas forcément le fonctionnement du playbook, mais les problèmes signalés peuvent indiquer la présence d'une erreur.
L'outil <code>yamllint</code> analyse un fichier YAML et tente d'identifier les problèmes liés à la syntaxe YAML. Cet outil n'a pas une connaissance directe d'Ansible, mais il peut intercepter des problèmes potentiels de syntaxe YAML.
}}

@@ Ligne 213 : / Ligne 213 : @@
 |operational
 | Display commands used for interfaces descriptions settings
 |-
 |{{CODE| show  \\  display set  }}
 |operational
 | Display commands used for all con figuration settings
 |}

@@ Ligne 170 : / Ligne 170 : @@
 ! Description
 |-
-|{{CODE|show system uptime }}
+|{{CODE|configure }}
 |operational
-| Get uptime & date of all fpc
+| Switch to configuration mode
 |-
-|{{CODE|show log messages }}
+|{{CODE|delete interface <interface> }}
 |operational
-| Dump system logs
+| Delete an interface (ex : delete xe-0/0/0)
 |-
-|{{CODE|show cli history }}
+|{{CODE|commit check }}
 |operational
-| Get cli commands history
+| Validate a conf without apply
 |-
-|{{CODE|show interfaces terse}}
+|{{CODE|commit }}
 |operational
-| Get a simplified view of all interfaces on the system
+| apply a modified conf
 |-
-|{{CODE|show interfaces [extensive]}}
+|{{CODE|commit confirmed <timeout in min>}}
 |operational
-|Get interface statistics
+| Apply a conf and roll back after x min if not commited in timelapse
 |-
-|{{CODE|show interfaces terse}}
+|{{CODE|load set terminal }}
 |operational
-| Get a simplified view of all interfaces on the system
+| Input a set of commands from the terminal until ^D is pressed
 |-
-|{{CODE|show lacp interfaces '''ae'''''xx'' [extensive]}}
+|{{CODE|set interfaces <interface name> mtu 9126 }}
 |operational
-|Get bond LACP interface statistics
+| Configure Jumbo frame on an interface
 |-
-|{{CODE|set interfaces INTERFACE …}}
+|{{CODE|set interfaces <interface name> unit 0 family ethernet-switching interface-mode trunk }}
-|configuration
+|operational
-|Configures an interface
+| Configure a TRUNK on an interface
 |-
-|{{CODE|set interfaces INTERFACE description}}
+|{{CODE|set interfaces <interface name> unit 0 family ethernet-switching vlan members [ VLANS or  vlans id ] }}
-|configuration
+|operational
-|Adds a description to an interface
+| Configure VLANs allowed in a trunk
 |-
-|{{CODE|set interfaces INTERFACE unit NUMBER family inet address …}}
+|{{CODE|delete apply-groups <group name> }}
-|configuration
+|operational
-|Configures an IPv4 address
+| Remove a group applied
 |-
-|{{CODE|set interfaces INTERFACE disable}}
+|{{CODE| show interfaces \\  display set \\ grep description }}
-|configuration
+|operational
-|Disables an interface
+| Display commands used for interfaces descriptions settings
-|-
+|}
 |-
-|{{CODE|show vlans}}
+|{{CODE| show  \\  display set  }}
 |operational
-|Shows a list of configured VLANs
+| Display commands used for all con figuration settings
 |}

← Version précédente		Version du 20 février 2023 à 17:51
Ligne 56 :		Ligne 56 :

	=Command Summary=		=Command Summary=
		+
		+
		+	{\| class="wikitable"
		+	!colspan="3"\|Juniper OS Command summary
		+	\|-
		+	! class="wikitable" \| Command
		+	! Mode
		+	! Description
		+	\|-
		+	\|{{CODE\|show system uptime }}
		+	\|operational
		+	\| Get uptime & date of all fpc
		+	\|-
		+	\|{{CODE\|show log messages }}
		+	\|operational
		+	\| Dump system logs
		+	\|-
		+	\|{{CODE\|show cli history }}
		+	\|operational
		+	\| Get cli commands history
		+	\|-
		+	\|{{CODE\|show interfaces terse}}
		+	\|operational
		+	\| Get a simplified view of all interfaces on the system
		+	\|-
		+	\|{{CODE\|show interfaces [extensive]}}
		+	\|operational
		+	\|Get interface statistics
		+	\|-
		+	\|{{CODE\|show interfaces terse}}
		+	\|operational
		+	\| Get a simplified view of all interfaces on the system
		+	\|-
		+	\|{{CODE\|show lacp interfaces '''ae'''''xx'' [extensive]}}
		+	\|operational
		+	\|Get bond LACP interface statistics
		+	\|-
		+	\|{{CODE\|set interfaces INTERFACE …}}
		+	\|configuration
		+	\|Configures an interface
		+	\|-
		+	\|{{CODE\|set interfaces INTERFACE description}}
		+	\|configuration
		+	\|Adds a description to an interface
		+	\|-
		+	\|{{CODE\|set interfaces INTERFACE unit NUMBER family inet address …}}
		+	\|configuration
		+	\|Configures an IPv4 address
		+	\|-
		+	\|{{CODE\|set interfaces INTERFACE disable}}
		+	\|configuration
		+	\|Disables an interface
		+	\|-
		+	\|{{CODE\|set vlans NAME vlan-id ID}}
		+	\|configuration
		+	\|Defines a VLAN
		+	\|-
		+	\|{{CODE\|show vlans}}
		+	\|operational
		+	\|Shows a list of configured VLANs
		+	\|-
		+	\|{{CODE\|set interfaces INTERFACE unit 0 family ethernet-switching interface-mode <access/trunk>}}
		+	\|configuration
		+	\|Sets a layer-2 port type (trunk port or access port)
		+	\|-
		+	\|{{CODE\|set interfaces INTERFACE unit 0 family ethernet-switching vlan members VLAN}}
		+	\|configuration
		+	\|Adds VLANs to the port
		+	\|-
		+	\|{{CODE\|set interfaces INTERFACE vlan-tagging}}
		+	\|configuration
		+	\|Enables VLAN tagging, which enables the use of units as subinterfaces
		+	\|-
		+	\|{{CODE\|set poe interface all}}
		+	\|configuration
		+	\|Enables PoE on all interfaces
		+	\|-
		+	\|{{CODE\|set protocols lldp-med interface all}}
		+	\|configuration
		+	\|Enables LLDP-MED on all interfaces
		+	\|-
		+	\|{{CODE\|rename}}
		+	\|configuration
		+	\|Renames some configuration
		+	\|-
		+	\|{{CODE\|deactivate}}
		+	\|configuration
		+	\|Deactivates any part of the config
		+	\|-
		+	\|{{CODE\|copy}}
		+	\|configuration
		+	\|Copy some configuration from one place to another
		+	\|-
		+	\|{{CODE\|replace}}
		+	\|configuration
		+	\|Replace some configuration
		+	\|-
		+	\|{{CODE\|annotate}}
		+	\|configuration
		+	\|Adds annotations into the config, like comments in code
		+
		+	\|}
		+
		+
		+	=Advanced Commands Summary=

@@ Ligne 72 : / Ligne 72 : @@
 |operational
 |Get interface statistics
 |-
 |{{CODE|set interfaces INTERFACE …}}
@@ Ligne 138 : / Ligne 146 : @@
 |}
 = Additional References =

Network/Juniper/Survival guide - Historique des versions

Admin : /* Advanced Commands Summary */

Admin : /* Advanced Commands Summary */

Admin : /* Command Summary */

Admin : /* Command Summary */

Admin : /* Command Summary */

Admin : /* Command Summary */

Admin : /* Command Summary */

Admin le 24 novembre 2022 à 18:17

Admin : Page créée avec « {{MediaWiki}} {{FOND_BLEU|Juniper- '''Petit guide de survie''' pour un newbie ...}} = Sites Références = * [https://www.juniper.net/documentation/us/en/software/j… »

Admin : Page créée avec « {{MediaWiki}}
{{FOND_BLEU|Juniper- '''Petit guide de survie''' pour un newbie ...}} = Sites Références = * [https://www.juniper.net/documentation/us/en/software/j… »