Chapitre 3. Création d’applications

Procédure

1. Il est possible de répertorier les paramètres avec le CLI 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 --parameters -n <project> <template_name>

   Copy to Clipboard Toggle word wrap

   À titre d’exemple, ce qui suit montre la sortie lors de la liste des paramètres de l’un des modèles de démarrage rapide dans le projet openshift par défaut:

   $ 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 avec un générateur d’expression régulier lorsque le modèle est traité.

Procédure

1. Le processus d’un fichier définissant un modèle pour retourner la liste des objets à la sortie standard:

   $ oc process -f <filename>

   Copy to Clipboard Toggle word wrap

   Alternativement, si le modèle a déjà été téléchargé dans le projet actuel:

   $ oc process <template_name>

   Copy to Clipboard Toggle word wrap

2. Créez des objets à partir d’un modèle en traitant le modèle et en comblant la sortie pour créer:

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

   Copy to Clipboard Toggle word wrap

   Alternativement, si le modèle a déjà été téléchargé dans le projet actuel:

   $ oc process <template> | oc create -f -

   Copy to Clipboard Toggle word wrap

3. Il est possible de remplacer les valeurs de paramètres définies dans le fichier en ajoutant l’option -p pour chaque paire <nom>=<valeur> que vous souhaitez remplacer. La référence de paramètre apparaît dans n’importe quel champ de texte à l’intérieur des éléments de modèle.

   Dans les paramètres POSTGRESQL_USER et POSTGRESQL_DATABASE suivants, les paramètres POSTGRESQL_DATABASE d’un modèle sont dépassé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 supprimant la sortie traitée vers 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. Lorsque vous disposez d’un grand nombre de paramètres, vous pouvez les stocker dans un fichier, puis passer ce fichier au processus oc:

      $ 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. Il est également possible de lire l’environnement à partir de l’entrée standard en utilisant "-" comme argument pour --param-file:

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

      Copy to Clipboard Toggle word wrap