Gestión de funciones mediante el plugin de OCI Functions para Visual Studio Code (VS Code)

Requisitos previos

Como con cualquier cliente de Oracle, obtenga una clave de firma de API. Para obtener orientación, consulte Cómo generar una clave de firma de API.

También debe instalar la extensión OCI Core, que está disponible en Visual Studio Marketplace.

Instalación del plugin

Para obtener instrucciones sobre cómo instalar el plugin de OCI Functions para Visual Studio Code, consulte Repositorio GitHub del plugin de OCI Functions para VS Code.

Tenga en cuenta que para desplegar las funciones que cree mediante el plugin de OCI Functions para Visual Studio Code, el perfil del usuario en el archivo ~/.oci/config debe incluir un campo user que especifique el OCID del usuario. Tenga en cuenta que si genera el archivo ~/.oci/config automáticamente seleccionando el botón Conectar, el perfil no contiene un campo user. Si este es el caso, agregue el campo user antes de desplegar funciones. Por ejemplo:

user=ocid1.user.oc1..aaaaaaaaa______adtw4r

Enumeración de aplicaciones y apertura de una aplicación para su edición

1. En la navegación de árbol de la parte izquierda, amplíe el nodo del compartimento que desee.

   Se muestran las aplicaciones a las que puede acceder.

2. Amplíe el nodo de la aplicación que desea editar.

Creación de una función

1. En la navegación de árbol de la parte izquierda, amplíe el nodo del compartimento que desee.
2. Haga clic con el botón derecho en el nodo de la aplicación que desee y seleccione Crear función....
3. Cree la nueva función de una de las siguientes maneras:

   • Crear a partir de una plantilla:

     1. Seleccione el método de creación Crear a partir de una plantilla en el campo de entrada de la barra de menús del editor de códigos.
     2. Seleccione una plantilla de la lista de plantillas.

        La nueva función se muestra en la navegación de árbol.

   • Crear a partir de un ejemplo:

     1. Seleccione el método de creación Crear a partir de un ejemplo en el campo de entrada de la barra de menús del editor de códigos.
     2. Seleccione una muestra de la lista de muestras.

        La nueva función se muestra en la navegación de árbol.

   • Crear a partir de un repositorio de código:

     1. Seleccione el método de creación Crear a partir de un repositorio de código en el campo de entrada de la barra de menús del editor de códigos.
     2. Introduzca un nombre para la función.
     3. Introduzca la URL del repositorio remoto que contiene el código de función. Por ejemplo, https://github.com/jdoe/simple-python-helloworld-repo

        La nueva función se muestra en la navegación de árbol.

Despliegue de una función

1. En la navegación de árbol de la parte izquierda, amplíe el nodo del compartimento que desee.
2. Expanda el nodo de la aplicación que desee.
3. Haga clic con el botón derecho en el nodo de la función que desea desplegar y seleccione Desplegar función....

   Si el perfil del usuario en el archivo ~/.oci/config no incluye un campo user que especifique el OCID del usuario (tal vez porque ha generado el archivo ~/.oci/config automáticamente seleccionando el botón Conectar), falta un cuadro de diálogo que le informa de que falta el campo user. Si ve el cuadro de diálogo, agregue el campo user al archivo ~/.oci/config antes de continuar.

4. Especifique:
   • Ubicación del registro: ubicación del registro en el que va a almacenar la función. Por ejemplo, phx.ocir.io
   • Token de autenticación: token de autenticación generado que se utilizará como contraseña al conectarse a Oracle Cloud Infrastructure Registry.

Edición de ajustes de función

1. En la navegación de árbol de la parte izquierda, amplíe el nodo del compartimento que desee.
2. Expanda el nodo de la aplicación que desee.
3. Haga clic con el botón derecho en el nodo de la función que desea editar y seleccione Editar configuración de función.
4. Especifique:
   • Timeout: tiempo máximo durante el que se puede ejecutar la función. La práctica recomendada consiste en especificar un timeout cercano al que es probable que sea necesario, en lugar de uno mucho mayor.
   • Memoria: umbral máximo de memoria para la función.

Adición y edición de parámetros de configuración personalizados

1. En la navegación de árbol de la parte izquierda, amplíe el nodo del compartimento que desee.
2. Expanda el nodo de la aplicación que desee.
3. Amplíe el nodo para la función que desee.
4. Seleccione el nodo Configuración para editar la configuración de la función.
5. Para definir un nuevo parámetro de configuración personalizado:

   1. Especifique:
      • Clave: nombre del parámetro de configuración personalizado. El nombre solo debe contener caracteres alfanuméricos y guiones bajos, y no debe empezar por un número. Por ejemplo, username
      • Nombre: valor del parámetro de configuración personalizado. El valor solo debe contener caracteres Unicode imprimibles. Por ejemplo, jdoe
   2. Seleccione el signo más (+).
6. Para editar un parámetro de configuración existente, seleccione el icono de lápiz junto al parámetro.
7. Seleccione Guardar.