Creación de aplicaciones
Descubra cómo crear aplicaciones con OCI Functions.
En OCI Functions, una aplicación es una agrupación lógica de funciones. Las propiedades especificadas para una aplicación determinan la asignación y configuración de recursos para todas las funciones de esa aplicación. Debe crear una función dentro de una aplicación, por lo que debe existir al menos una aplicación para poder crear una función en OCI Functions.
Para obtener más información sobre las aplicaciones, consulte Aplicaciones.
- Confirme que ha completado los pasos de las Guías de Functions QuickStart.
- En la página de lista Aplicaciones, seleccione el compartimento especificado en el contexto de la CLI de Fn Project (consulte Creating an Fn Project CLI Context to Connect to Oracle Cloud Infrastructure). Si necesita ayuda para buscar la página de lista, consulte Listado de aplicaciones.
-
Seleccione Crear aplicación y especifique los siguientes detalles:
- Nombre: el nombre de la nueva aplicación (por ejemplo, acmeapp). Evite introducir información confidencial.
- VCN en <compartment-name>: VCN (red virtual en la nube) en la que ejecutar funciones. Por ejemplo, una VCN denominada acme-vcn-01
- Subredes en <compartment-name>: subred (o subredes, hasta un máximo de tres) en la que ejecutar las funciones. Por ejemplo, una subred pública denominada subred pública IHsY:US-PHOENIX-AD-1).
Una subred pública necesita un gateway de Internet en la VCN y una subred privada necesita un gateway de servicio en la VCN. Si se ha definido una subred regional, como mejor práctica, seleccione esa subred para facilitar la implantación del failover en los dominios de disponibilidad. Si no se ha definido una subred regional y debe cumplir requisitos de alta disponibilidad, seleccione varias subredes. Recomendamos que las subredes se encuentren en la misma región que el registro de Docker especificado en el contexto de la CLI de Fn Project. Para obtener más información, consulte Creación de un contexto de CLI de Fn Project para conectarse a Oracle Cloud Infrastructure.
La especificación de una subred privada para una aplicación no impide el acceso desde Internet a los puntos finales de llamada de las funciones de la aplicación. Utilice políticas de identidad para controlar el acceso a los puntos finales de llamada de función. Para obtener más información, consulte Controlling Access to Invoke and Manage Functions.
-
Unidad: arquitectura de procesador de las instancias informáticas en las que desplegar y ejecutar funciones en la aplicación. Todas las funciones de la aplicación se despliegan y ejecutan en instancias informáticas con la misma arquitectura. La imagen de la función debe contener las dependencias necesarias para la arquitectura que seleccione, de la siguiente manera:
- Seleccione la unidad Generic_ARM si desea que las funciones de la aplicación se ejecuten siempre en instancias informáticas con una arquitectura basada en Arm. Si selecciona esta unidad de arquitectura única para la aplicación, la imagen de la función debe contener las dependencias necesarias para la arquitectura Arm (en una sola imagen de arquitectura o en una imagen de arquitectura múltiple).
- Seleccione la unidad Generic_X86 si desea que las funciones de la aplicación se ejecuten siempre en instancias informáticas con una arquitectura basada en x86. Si selecciona esta unidad de arquitectura única para la aplicación, la imagen de la función debe contener las dependencias necesarias para la arquitectura x86 (en una sola imagen de arquitectura o en una imagen de arquitectura múltiple).
- Seleccione la unidad Generic_X86_ARM si desea que las funciones se ejecuten en instancias informáticas con la arquitectura que tenga capacidad suficiente. En este caso, OCI Functions selecciona la arquitectura en la que se ejecutan las funciones en función de la capacidad disponible. Si selecciona esta unidad de arquitectura múltiple para la aplicación, la imagen de cada función debe contener las dependencias necesarias tanto para la arquitectura Arm como para la arquitectura x86 (en una imagen de arquitectura múltiple).
Tenga en cuenta que no puede cambiar la unidad de la aplicación después de crearla. Consulte Selección de una única arquitectura o unidad de aplicación de arquitectura múltiple en la que ejecutar una función.
- Opciones de etiquetado: si tiene permisos para crear un recurso, entonces también dispone de permisos para aplicar etiquetas de formato libre a dicho recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de la etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar etiquetas más tarde.
-
Seleccione una de las opciones siguientes:
- Para crear la aplicación ahora, seleccione Crear. La nueva aplicación aparece en la lista de aplicaciones.
- Para crear la aplicación más tarde mediante Resource Manager y Terraform, seleccione Guardar como pila para guardar la definición de recurso como una configuración de Terraform. Para obtener más información sobre cómo guardar pilas de definiciones de recursos, consulte Creación de una pila a partir de una página de creación de recursos.
Con la CLI de Fn Project
Consejo
De vez en cuando, se lanzan nuevas versiones de la CLI de Fn Project. Le recomendamos que compruebe regularmente que la última versión está instalada. Para obtener más información, consulte Steps to upgrade the Fn Project CLI.Para crear una nueva aplicación en OCI Functions mediante la CLI de Fn Project:
-
Conéctese al entorno de desarrollo como desarrollador de funciones.
-
En una ventana de terminal, introduzca lo siguiente para crear una nueva aplicación:
fn create app <app-name> --annotation oracle.com/oci/subnetIds='["<subnet-ocid>"]'
donde:
<app-name>
es el nombre de la nueva aplicación. Evite introducir información confidencial.<subnet-ocid>
es el OCID de la subred (o subredes, hasta un máximo de tres) en el que ejecutar las funciones. Tenga en cuenta que una subred pública necesita un gateway de Internet en la VCN, y una subred privada necesita un gateway de servicio en la VCN. Si se ha definido una subred regional, la práctica recomendada es seleccionar esa subred para que el failover entre los dominios de disponibilidad sea más fácil de implementar. Si no se ha definido una subred regional y necesita cumplir los requisitos de alta disponibilidad, especifique varias subredes (incluya cada OCID entre comillas dobles separadas por comas, en el formato'["<subnet-ocid>","<subnet-ocid>"]'
). Oracle recomienda que las subredes estén en la misma región que el registro Docker especificado en el contexto de la CLI de Fn Project (consulte Creación de un contexto de la CLI de Fn Project para conectarse a Oracle Cloud Infrastructure).Tenga en cuenta que la especificación de una subred privada para una aplicación no impide el acceso desde Internet a los puntos finales de llamada de las funciones de la aplicación. Utilice políticas de identidad para controlar el acceso a los puntos finales de llamada de función (consulte Control de acceso para llamar y gestionar funciones).
Por ejemplo:
fn create app acmeapp --annotation oracle.com/oci/subnetIds='["ocid1.subnet.oc1.phx.aaaaaaaacnh..."]'
Se crea una aplicación en OCI Functions, en el arrendamiento y la región implícitos por el OCID de subred y pertenecientes al compartimento especificado en el archivo de contexto de la CLI de Fn Project.
-
Verifique que la nueva aplicación se ha creado; para ello, introduzca:
fn list apps
Por ejemplo:
$ fn list apps acmeapp
Uso de la CLI de OCI
Utilice el comando oci fn application create y los parámetros necesarios para crear una aplicación:
oci fn application create --compartment-id <compartment-ocid> --display-name <app-name> --subnet-ids <subnet-ocids> [OPTIONS]
Para obtener una lista completa de indicadores y opciones variables para los comandos de la CLI de OCI, consulte la Referencia de la línea de comandos.
-
Ejecute la operación de API CreateApplication para crear una aplicación.