Crea archivos de configuración JSON para tus implementaciones

Para implementar una versión de tu aplicación con la API de administrador, define los detalles de la configuración de tu versión con un archivo con formato JSON. Puedes crear manualmente el archivo de configuración o convertir un archivo app.yaml existente.

Hay dos pasos para crear un archivo de configuración con formato JSON:

  1. Define la información de configuración de la versión que deseas implementar.
  2. Define una sección de deployment para especificar todos los archivos y recursos de la aplicación que deseas implementar.

Sugerencia: Tal vez sea conveniente que generes el archivo de configuración app.json de manera programática.

Antes de comenzar

Debes subir todos los archivos y recursos de tu aplicación a un depósito de Cloud Storage antes de que puedas crear el archivo de configuración app.json.

Crea el archivo de configuración JSON manualmente

Sigue los pasos que se indican a continuación si necesitas crear el archivo de configuración manualmente (por ejemplo, si tu aplicación excluye un archivo app.yaml o tu aplicación de Java existente usa un archivo appengine-web.xml).

Para crear manualmente el archivo de configuración app.json a fin de implementar tu aplicación con la API de administrador, haz lo siguiente:

  1. Crea un archivo con el nombre app.json.
  2. Usa la información de configuración que se proporciona en la colección apps.services.versions para definir y configurar la versión que quieres implementar.
  3. Usa la plantilla de Crea la sección deployment para especificar todos los archivos y recursos que quieres implementar desde tu depósito de Cloud Storage.

Consulta también la sección con el ejemplo que aparece a continuación, ya que te ayudará a crear tu archivo de configuración app.json.

Convierte un archivo app.yaml al formato JSON

Puedes usar la herramienta convert_yaml.py para convertir y generar una versión de app.json a partir de un archivo app.yaml existente.

Si existe un archivo app.yaml, que normalmente usas para implementar versiones de tu aplicación de forma manual, puedes conservar esa información si conviertes las opciones de configuración al formato JSON.

Requisitos

Descarga y, luego, instala la herramienta convert_yaml.py, así como lo que se especifique en los requisitos.

Convierte archivos YAML con la herramienta convert_yaml.py

Para convertir tu archivo app.yaml con la herramienta convert_yaml.py, haz lo siguiente:

  1. Localiza y anota la ruta del directorio de tu app.yaml.

    Ejemplo:

    cd root/apps-container/my-application/
    

    Donde el archivo app.yaml de la aplicación example-python-app.py podría verse de la siguiente forma:

    service: default
    version: v1
    runtime: python27
    threadsafe: true
    
    handlers:
    - url: /.*
      script: example-python-app.py
    
  2. Navega al directorio local donde descargaste la herramienta convert_yaml.py, por ejemplo:

    cd root/tools/appengine-config-transformer
    
  3. Ejecuta la herramienta convert_yaml.py para crear el archivo app.json a partir del archivo app.yaml:

    python ./convert_yaml.py [DIRECTORY_PATH]/app.yaml > [DIRECTORY_PATH]/app.json
    

    Donde [DIRECTORY_PATH] es la ruta del directorio de tu archivo app.yaml.

    Se crea una versión JSON (app.json) de tu archivo app.yaml en el directorio [DIRECTORY_PATH].

  4. Asegúrate de que el ID de tu versión se defina en el archivo de configuración app.json.

    Si tu archivo app.yaml excluye el elemento version: [VERSION_NAME], el elemento "id": [VERSION_NAME] no se incluye en el archivo app.json después de la conversión. Por ejemplo, si deseas configurar el ID de versión como v1, debes agregar manualmente la siguiente línea a tu archivo app.json:

    "id": "v1",
    
  5. Usa la plantilla de Crea la sección deployment para especificar todos los archivos y recursos de la aplicación que quieres implementar.

Consulta también la sección con el ejemplo que aparece a continuación, ya que te ayudará a crear tu archivo de configuración app.json.

Crea la sección deployment

Para crear una sección deployment en el archivo de configuración app.json y definir manualmente todos los recursos ubicados en tu depósito de Cloud Storage, usa la información de referencia que se brinda en la sección deployment de la colección apps.services.versions. Si estás definiendo archivos individuales, puedes usar la siguiente plantilla:

"deployment": {
  "files": {
    "my-resource-file1": {
      "sourceUrl": "https://storage.googleapis.com/[MY_BUCKET_ID]/my-application/my-resource-file1"
    },
  }
},

En esta plantilla, my-resource-file1 define el nombre de archivo y la ruta de directorio relativa de la ubicación en la que quieres implementar ese archivo en App Engine.

Ejemplo de archivo app.json

Usa el siguiente ejemplo de app.json como ayuda para crear tu archivo de configuración.

En el siguiente ejemplo de app.json, se define el ID de la versión v1 junto con una sección deployment que incluye dos archivos de origen de ejemplo ubicados en el depósito de Cloud Storage [MY_BUCKET_ID].

{
  "deployment": {
    "files": {
      "example-resource-file1": {
        "sourceUrl": "https://storage.googleapis.com/[MY_BUCKET_ID]/example-application/example-resource-file1"
      },
      "images/example-resource-file2": {
        "sourceUrl": "https://storage.googleapis.com/[MY_BUCKET_ID]/example-application/images/example-resource-file2"
      },
    }
  },
  "id": "v1",
  "handlers": [
    {
      "urlRegex": "/.*",
      "script": {
        "scriptPath": "example-python-app.py"
      }
    },
  ],
  "runtime": "python27",
  "threadsafe": true,
}

Sugerencia: No todos los entornos de ejecución compatibles con App Engine admiten un ScriptHandler. Para obtener más información, consulta la referencia de app.yaml o appengine-web.xml correspondiente al entorno de ejecución del lenguaje que estés utilizando.

Pasos siguientes

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

App Engine Admin API