Utiliser l'utilitaire apigee-adminapi.sh

Edge pour Private Cloud version 4.17.01

Utilisez le fichier apigee-adminapi.sh utilitaire pour effectuer les mêmes tâches de configuration Edge que vous effectuez en effectuant des appels vers le l'API de gestion de projet. L'avantage de l'utilitaire apigee-adminapi.sh est que comme suit:

  • Utiliser une interface de ligne de commande simple
  • Implémenter l'exécution de commandes par onglets
  • Fournit de l'aide et des informations sur l'utilisation
  • Peut afficher l'appel d'API correspondant si vous décidez d'essayer l'API

L'utilitaire apigee-adminapi.sh n'est pas remplacer l'utilitaire apigee-provision. L'utilitaire apigee-provision utilise en fait le apigee-adminapi.sh pour pour accomplir ses tâches.

Voici les principales différences entre les deux:

  • L'utilitaire apigee-adminapi.sh exécute des fonctions atomiques qui remplacent les appels d'API Edge individuels. Par exemple, pour créer l'organisation, l'environnement et l'hôte virtuel nécessitent trois commandes apigee-adminapi.sh distinctes correspondant à trois appels d'API.
  • Le paramètre apigee-provision est conçu pour effectuer une opération complète de haut niveau en une seule commande. Pour Par exemple, vous pouvez créer une organisation, un environnement et un hôte virtuel apigee-provision par en transmettant un fichier de configuration contenant toutes les informations nécessaires.

La documentation Edge utilise les deux utilitaires le cas échéant.

Installer apigee-adminapi.sh

L'utilitaire apigee-adminapi.sh automatiquement installé lorsque vous installez l'utilitaire apigee-provision ou apigee-validate.

L'utilitaire est installé à l'emplacement suivant:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh

Syntaxe de apigee-adminapi.sh

L'utilitaire apigee-adminapi.sh utilise une syntaxe de ligne de commande simple. Vous pouvez à tout moment utiliser la touche de tabulation pour afficher une invite listant les options de commande disponibles.

Pour afficher toutes les commandes possibles, appelez l'utilitaire sans aucune option:

> apigee-adminapi.sh 

Si vous appuyez sur la touche de tabulation après avoir saisi apigee-adminapi.sh, vous verrez la liste des options:

analytics  classification  logsessions  regions  securityprofile  userroles
buildinfo  GET             orgs         runtime  servers          users

La touche de tabulation affiche les options en fonction du contexte de la commande. Si vous saisissez la touche de tabulation après avoir saisi:

> apigee-adminapi.sh orgs

Les options disponibles pour exécuter la commande orgs s'affichent:

add  apis  apps  delete  envs  list  pods  userroles

Utilisez l'option -h pour afficher pour n'importe quelle commande. Par exemple, si vous utilisez l'option -h comme indiqué ci-dessous:

> apigee-adminapi.sh orgs -h

L'utilitaire affiche des informations d'aide complètes pour toutes les options possibles de la commande orgs. Le premier élément de la sortie affiche l'aide associée à la commande "orgs add" :

+++++++++++++++++++++++++++++++++++++++++++
orgs add
  Required:
    -o ORG Organization name
  Optional:
    -H HEADER add http header in request
    --admin ADMIN_EMAIL admin email address
    --pwd ADMIN_PASSWORD admin password
    --host EDGE_SERVER edge server to make request to
    --port EDGE_PORT port to use for the http request
    --ssl set EDGE_PROTO to https, defaults to http
    --debug ( set in debug mode, turns on verbose in curl )
    -h      Displays Help

Définir des paramètres à l'aide de commutateurs de ligne de commande et de variables d'environnement

Vous devez saisir tous les paramètres d'une commande à l'aide de commutateurs de ligne de commande ou en utilisant variables d'environnement. Ajoutez un simple tiret (-) ou un double tiret aux commutateurs de ligne de commande. (--) selon les besoins.

Par exemple, dans l'aide affichée ci-dessus pour l'option "ajout aux organisations", vous pouvez spécifier le nom de l'organisation de l'une des manières suivantes:

  • En utilisant la ligne de commande -o bouton bascule:
    > Organisations apigee-adminapi.sh -o testOrg
  • Définir une variable d'environnement nommée ORG:
    > export ORG=testOrg
    > Organisations apigee-adminapi.sh

Si vous omettez des paramètres obligatoires dans la commande, l'utilitaire affiche un message d'erreur décrivant les paramètres manquants. Par exemple, si vous omettez la variable d'environnement --host ou EDGE_SERVER spécifiant Edge Management Server lors de la création d'une organisation, le message d'erreur suivant s'affiche:

Error with required variable or parameter
ADMIN_PASSWORD....OK
ADMIN_EMAIL....OK
EDGE_SERVER....null

Deux paramètres courants que vous définissez souvent comme variables d'environnement sont l'adresse e-mail d'administrateur système et adresse IP du serveur de gestion:

> export ADMIN_EMAIL=foo@bar.com
> export EDGE_SERVER=192.168.56.101

Transmettre un fichier à apigee-adminapi.sh fournisseur d'énergie

Certaines commandes utilitaires apigee-adminapi.sh correspondent aux appels d'API PUT et POST qui acceptent un corps de requête. Par exemple, la création d'une "host" correspond à un appel d'API POST qui nécessite des informations sur l'hôte virtuel dans corps de la requête.

Lorsque vous utilisez l'utilitaire apigee-adminapi.sh pour créer un hôte virtuel ou toute commande qui accepte un corps de requête, vous pouvez transmettre toutes les les informations nécessaires sur la ligne de commande, comme indiqué ci-dessous:

> apigee-adminapi.sh orgs envs virtual_hosts add -e prod -o testOrg --host localhost --admin foo@bar.com -v myVHostUtil -p 9005 -a 192.168.56.101:9005

Vous pouvez également transmettre un fichier contenant les mêmes informations que celles contenues dans la demande. corps de la requête POST. Par exemple, la commande suivante utilise un fichier définissant l'hôte virtuel:

> apigee-adminapi.sh orgs envs virtual_hosts add -e prod -o testOrg --host localhost --admin foo@bar.com -f vhostcreate

où le fichier vhostcreate contient le corps POST de l'appel. Dans cet exemple, il s'agit d'un corps de requête au format XML:

<VirtualHost name="myVHostUtil">
   <HostAliases>
     <HostAlias>192.168.56.101:9005</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

Afficher les informations de débogage et d'API

Utilisez l'option --debug pour l'utilitaire apigee-adminapi.sh pour afficher des informations détaillées sur la commande. Ces informations incluent la commande cURL généré par l'utilitaire apigee-adminapi.sh pour effectuer l'opération.

Par exemple, cette commande utilise l'option --debug:

> apigee-adminapi.sh orgs add -o testOrg2 --admin foo@bar.com --host localhost --debug

Il affiche le résultat suivant, y compris la commande cURL générée:

curl -H Content-Type: application/xml -v -X POST     -s -k -w \n==> %{http_code} 
-u ***oo@bar.com:*****     http://localhost:8080/v1/o -d <Organization name="testOrg2" 
type="paid"/>
* About to connect() to localhost port 8080 (#0)
*   Trying ::1... connected
* Connected to localhost (::1) port 8080 (#0)
* Server auth using Basic with user 'foo@bar.com'
> POST /v1/o HTTP/1.1
> Authorization: Basic c2dp234234NvbkBhcGlnZ2342342342342341Q5
> User-Agent: curl/7.19.7 (x86_64-redhat-linux-gnu) libcurl/7.19.7 NSS/3.19.1
Basic ECC zlib/1.2.3 libidn/1.18 libssh2/1.4.2
> Host: localhost:8080
> Accept: */*
> Content-Type: application/xml
> Content-Length: 43
>
} [data not shown]
< HTTP/1.1 201 Created
< Content-Type: application/json
< Date: Tue, 03 May 2016 02:08:32 GMT
< Content-Length: 291
<
{ [data not shown]
* Connection #0 to host localhost left intact
* Closing connection #0