Scripts de configuration de groupe de noeuds
La bibliothèque de scripts propose de nombreuses procédures de script pour automatiser la configuration des serveurs. Consultez cette rubrique pour savoir comment utiliser les scripts qui interrogent, configurent et gèrent vos configurations de noeud. Vous pouvez exécuter chaque script individuellement ou combiner des procédures pour créer des scripts d'automatisation personnalisés pour votre environnement.
Les groupes de noeuds permettent de définir des groupes de noeuds capables d'héberger des membres du même cluster. Une application déployée sur un cluster doit être capable de s'exécuter sur n'importe quel membre du cluster. Le noeud qui héberge chacun des membres du cluster doit être configuré avec le logiciel et les paramètres nécessaires à la prise en charge de l'application.
En organisant des noeuds répondant aux besoins de votre application en groupes de noeuds, vous définissez une règle d'administration qui détermine les noeuds susceptibles d'être regroupés en cluster. Les personnes chargées de définir la configuration de la cellule et celles chargées de créer les clusters de serveurs bénéficient de plus d'indépendance dans leur travail.
addNodeGroupMember
Ce script ajoute un noeud à un groupe de noeuds qui existe déjà dans votre configuration.
Argument | Description |
---|---|
nodeName | Spécifie un nom logique pour le membre du groupe de noeuds. Un membre de groupe de noeuds est un noeud. Le nom doit être unique dans la cellule. En général, le nom du membre du groupe de noeuds est identique au nom d'hôte de l'ordinateur. |
nodeGroupName | Spécifie un nom logique pour le groupe de noeuds. Le nom doit être unique dans la cellule. Il peut commencer par un chiffre. |
Syntaxe
AdminNodeGroupManagement.addNodeGroupMember(nodeName, discoveryProtocol)
Exemple de syntaxe
AdminNodeGroupManagement.addNodeGroupMember("myNode", "myNodeGroup")
checkIfNodeExists
Ce script détecte si le noeud recherché existe dans un groupe de noeuds spécifique.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du groupe de noeuds à interroger. |
nodeName | Indique le nom du noeud de noeuds à interroger. |
Syntaxe
AdminNodeGroupManagement.checkIfNodeExists(nodeGroupName, nodeName)
Exemple de syntaxe
AdminNodeGroupManagement.checkIfNodeExists("myNodeGroup", "myNode")
checkIfNodeGroupExists
Ce script détecte si un groupe de noeuds spécifique existe dans votre configuration.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du groupe de noeuds à interroger. |
Syntaxe
AdminNodeGroupManagement.checkIfNodeGroupExists(nodeGroupName)
Exemple de syntaxe
AdminNodeGroupManagement.checkIfNodeGroupExists("myNodeGroup")
createNodeGroup
Ce script crée un nouveau groupe de noeuds dans votre configuration.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du groupe de noeuds à créer. |
Syntaxe
AdminNodeGroupManagement.createNodeGroup("nodeGroupName")
Exemple de syntaxe
AdminNodeGroupManagement.createNodeGroup("myNodeGroup")
createNodeGroupProperty
Ce script affecte des propriétés personnalisées au groupe de noeuds qui vous intéresse.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du noeud qui vous intéresse. |
customPropertyName | Indique le nom ou la clé de la propriété. Chaque nom de propriété doit être unique. Si le même nom est utilisé pour plusieurs propriétés, la valeur spécifiée pour la première propriété portant ce nom est utilisée. Ne faites pas commencer les noms de propriétés par was car ce préfixe est réservé aux propriétés prédéfinies dans le serveur d'applications. |
customPropertyValue | Indique la valeur à attribuer à la propriété personnalisée. |
customPropertyDesc | Argument facultatif - Associe une description à la propriété personnalisée à créer. |
isPropertyRequired | Argument facultatif - Indique si la propriété personnalisée est obligatoire dans votre configuration. Spécifiez true pour rendre la propriété personnalisée obligatoire dans votre configuration. |
Syntaxe
AdminNodeGroupManagement.createNodeGroupProperty(nodeGroupName, customPropertyName,
customPropertyValue, customPropertyDesc, isPropertyRequired)
Exemple de syntaxe
AdminNodeGroupManagement.createNodeGroupProperty("myNodeGroup", "myProp", "myPropValue",
"this is my prop", "true")
deleteNodeGroup
Ce script supprime un groupe de noeuds de votre configuration.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du groupe de noeuds à supprimer. |
Syntaxe
AdminNodeGroupManagement.deleteNodeGroup(nodeGroupName)
Exemple de syntaxe
AdminNodeGroupManagement.deleteNodeGroup("myNodeGroup")
deleteNodeGroupMember
Ce script supprime un noeud d'un groupe de noeuds spécifique dans votre configuration.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du groupe de noeuds qui vous intéresse. |
nodeName | Indique le nom du noeud à supprimer du groupe de noeuds. |
Syntaxe
AdminNodeGroupManagement.deleteNodeGroupMember(nodeGroupName, nodeName)
Exemple de syntaxe
AdminNodeGroupManagement.deleteNodeGroupMember("myNodeGroup", "myNode")
deleteNodeGroupProperty
Ce script supprime une propriété personnalisée spécifique d'un groupe de noeuds.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du groupe de noeuds qui vous intéresse. |
customPropertyName | Indique le nom de la propriété personnalisée à supprimer de la configuration de votre groupe de noeuds. |
Syntaxe
AdminNodeGroupManagement.deleteNodeGroupProperty(nodeGroupName, customPropertyName)
Exemple de syntaxe
AdminNodeGroupManagement.deleteNodeGroupProperty("myNodeGroup", "myProp")
help
Argument | Description |
---|---|
script | Indique le nom du script qui vous intéresse. |
Syntaxe
AdminServerManagement.help(script)
Exemple de syntaxe
AdminServerManagement.help("modifyNodeGroupProperty")
listNodeGroups
Argument | Description |
---|---|
nodeName | Argument facultatif - Indique le nom du noeud à utiliser pour interroger les groupes de noeuds. |
Syntaxe
AdminNodeGroupManagement.listNodeGroups()
Exemple de syntaxe
AdminNodeGroupManagement.listNodeGroups()
listNodeGroupMembers
Ce script répertorie tous les noms de noeud configurés au sein d'un groupe de noeuds spécifique.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du groupe de noeuds qui vous intéresse. |
Syntaxe
AdminNodeGroupManagement.listNodeGroupMembers(nodeGroupName)
Exemple de syntaxe
AdminNodeGroupManagement.listNodeGroupMembers("myNodeGroup")
listNodeGroupProperties
Ce script répertorie les propriétés personnalisées configurées au sein d'un groupe de noeuds spécifique.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du groupe de noeuds qui vous intéresse. |
Syntaxe
AdminNodeGroupManagement.listNodeGroupProperties(nodeGroupName)
Exemple de syntaxe
AdminNodeGroupManagement.listNodeGroupProperties("myNodeGroup")
modifyNodeGroup
Ce script modifie le nom abrégé et la description d'un groupe de noeuds.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du groupe de noeuds qui vous intéresse. |
shortName | Indique le nom abrégé du groupe de noeuds qui vous intéresse. |
description | Indique la description du groupe de noeuds. |
Syntaxe
AdminNodeGroupManagement.listNodeGroupProperties(nodeGroupName, shortName,
description)
Exemple de syntaxe
AdminNodeGroupManagement.listNodeGroupProperties("myNodeGroup", "NG1", "my first node group")
modifyNodeGroupProperty
Ce script modifie la valeur d'une propriété personnalisée associée à un groupe de noeuds.
Argument | Description |
---|---|
nodeGroupName | Indique le nom du groupe de noeuds qui vous intéresse. |
customPropertyName | Indique le nom de la propriété personnalisée à modifier. |
customPropertyValue | Argument facultatif - Indique la nouvelle valeur de la propriété personnalisée qui vous intéresse. |
customPropertyDescription | Argument facultatif - Associe une description à la propriété personnalisée. |
isPropertyRequired | Argument facultatif - Spécifie si la propriété personnalisée est obligatoire. |
Syntaxe
AdminNodeGroupManagement.modifyNodeGroupProperty(nodeGroupName, customPropertyName,
customPropertyValue, customPropertyDescription, isPropertyRequired)
Exemple de syntaxe
AdminNodeGroupManagement.modifyNodeGroupProperty("myNodeGroup", "customProp", "newValue",
"new description of property", "false")