10.4. Création d'objets à partir de modèles à l'aide de l'interface de programmation

Procédure

1. Vous pouvez dresser la liste des paramètres à l'aide de l'interface de gestion en utilisant la commande suivante et en spécifiant le fichier à utiliser :

   $ oc process --parameters -f <filename>

   Copy to Clipboard Toggle word wrap

   Alternativement, si le modèle est déjà téléchargé :

   $ oc process --paramètres -n <projet> <nom_du_modèle>

   Copy to Clipboard Toggle word wrap

   Par exemple, l'exemple suivant montre le résultat de la liste des paramètres pour l'un des modèles de démarrage rapide dans le projet par défaut openshift:

   $ oc process --parameters -n openshift rails-postgresql-example

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   NAME                         DESCRIPTION                                                                                              GENERATOR           VALUE
   SOURCE_REPOSITORY_URL        The URL of the repository with your application source code                                                                  https://github.com/sclorg/rails-ex.git
   SOURCE_REPOSITORY_REF        Set this to a branch name, tag or other ref of your repository if you are not using the default branch
   CONTEXT_DIR                  Set this to the relative path to your project if it is not in the root of your repository
   APPLICATION_DOMAIN           The exposed hostname that will route to the Rails service                                                                    rails-postgresql-example.openshiftapps.com
   GITHUB_WEBHOOK_SECRET        A secret string used to configure the GitHub webhook                                                     expression          [a-zA-Z0-9]{40}
   SECRET_KEY_BASE              Your secret key for verifying the integrity of signed cookies                                            expression          [a-z0-9]{127}
   APPLICATION_USER             The application user that is used within the sample application to authorize access on pages                                 openshift
   APPLICATION_PASSWORD         The application password that is used within the sample application to authorize access on pages                             secret
   DATABASE_SERVICE_NAME        Database service name                                                                                                        postgresql
   POSTGRESQL_USER              database username                                                                                        expression          user[A-Z0-9]{3}
   POSTGRESQL_PASSWORD          database password                                                                                        expression          [a-zA-Z0-9]{8}
   POSTGRESQL_DATABASE          database name                                                                                                                root
   POSTGRESQL_MAX_CONNECTIONS   database max connections                                                                                                     10
   POSTGRESQL_SHARED_BUFFERS    database shared buffers                                                                                                      12MB

   Copy to Clipboard Toggle word wrap

   La sortie identifie plusieurs paramètres qui sont générés à l'aide d'un générateur d'expressions régulières lorsque le modèle est traité.

Procédure

1. Traite un fichier définissant un modèle pour renvoyer la liste des objets sur la sortie standard :

   $ oc process -f <filename>

   Copy to Clipboard Toggle word wrap

   Sinon, si le modèle a déjà été téléchargé dans le projet en cours :

   oc process <nom_du_modèle>

   Copy to Clipboard Toggle word wrap

2. Créer des objets à partir d'un modèle en traitant le modèle et en acheminant la sortie vers oc create:

   oc process -f <filename> $ oc create -f -

   Copy to Clipboard Toggle word wrap

   Sinon, si le modèle a déjà été téléchargé dans le projet en cours :

   oc process <template> | oc create -f -

   Copy to Clipboard Toggle word wrap

3. Vous pouvez remplacer toutes les valeurs de paramètres définies dans le fichier en ajoutant l'option -p pour chaque paire <name>=<value> que vous souhaitez remplacer. Une référence de paramètre apparaît dans n'importe quel champ de texte à l'intérieur des éléments du modèle.

   Par exemple, dans l'exemple suivant, les paramètres POSTGRESQL_USER et POSTGRESQL_DATABASE d'un modèle sont remplacés pour produire une configuration avec des variables d'environnement personnalisées :

   1. Création d'une liste d'objets à partir d'un modèle

      $ oc process -f my-rails-postgresql \
          -p POSTGRESQL_USER=bob \
          -p POSTGRESQL_DATABASE=mydatabase

      Copy to Clipboard Toggle word wrap

   2. Le fichier JSON peut être redirigé vers un fichier ou appliqué directement sans télécharger le modèle en envoyant la sortie traitée à la commande oc create:

      $ oc process -f my-rails-postgresql \
          -p POSTGRESQL_USER=bob \
          -p POSTGRESQL_DATABASE=mydatabase \
          | oc create -f -

      Copy to Clipboard Toggle word wrap

   3. Si vous avez un grand nombre de paramètres, vous pouvez les stocker dans un fichier et passer ce fichier à oc process:

      $ cat postgres.env
      POSTGRESQL_USER=bob
      POSTGRESQL_DATABASE=mydatabase

      Copy to Clipboard Toggle word wrap

      $ oc process -f my-rails-postgresql --param-file=postgres.env

      Copy to Clipboard Toggle word wrap

   4. Vous pouvez également lire l'environnement à partir de l'entrée standard en utilisant "-" comme argument de --param-file:

      $ sed s/bob/alice/ postgres.env | oc process -f my-rails-postgresql --param-file=-

      Copy to Clipboard Toggle word wrap