Note:

Uso de OCI Functions y Python para abrir tickets en Jira Service Management

Introducción

El siguiente tutorial está dirigido a los usuarios de Oracle Cloud Infrastructure (OCI) que utilizan el servicio OCI Monitoring y Jira Service Management para abrir tickets y realizar un seguimiento de los incidentes. Supongamos que tiene una instancia de OCI y desea saber cuándo la instancia cae inesperadamente debido a algún error. Desea recibir una notificación y abrir un ticket en Jira Service Management inmediatamente para que el ingeniero de servicio pueda empezar a investigar y solucionar el problema lo antes posible. Con el servicio OCI Functions, los tickets se pueden abrir automáticamente en Jira Service Management cuando se detectan problemas con los sistemas de su organización.

Objetivos

Requisitos

Tarea 1: Creación de una red virtual en la nube

Una red virtual en la nube (VCN) es una red que se define en OCI. Incluye subredes, tablas de rutas y gateways.

  1. Haga clic en el menú de servicios Menú Servicios situado cerca de la esquina superior izquierda de la consola de OCI.

  2. En Red, seleccione Redes virtuales en la nube.

  3. En la página Redes virtuales en la nube, haga clic en Iniciar asistente de VCN.

  4. Seleccione Create VCN with Internet Connectivity y haga clic en Start VCN Wizard.

  5. Complete la configuración de la VCN, haga clic en Siguiente y en Crear.

Tarea 2: Creación de un grupo dinámico

Los grupos dinámicos permiten agrupar instancias de OCI Compute como actores principales (de manera similar a los grupos de usuarios).

Nota: Necesita privilegios de administrador para crear grupos dinámicos.

  1. En el menú de servicios, vaya a Identidad y seguridad, Identidad y haga clic en Grupos dinámicos.

  2. Haga clic en Crear grupo dinámico.

  3. Introduzca un nombre y una descripción significativos.

  4. En la sección Regla 1, agregue la siguiente línea:

    ALL {resource.type = 'fnfunc', resource.compartment.id = 'ocid1.compartment.oc1', instance.compartment.id = 'ocid1.compartment.oc1'}

    Nota: Sustituya el ID de compartimento por el ID de compartimento deseado.

  5. Haga clic en Crear.

Tarea 3: Creación de políticas de OCI IAM

Oracle Cloud Infrastructure Identity and Access Management (OCI IAM) le permite controlar quién tiene acceso a sus recursos en la nube. Para que esta integración funcione, necesitamos otorgar acceso a los servicios de Función como servicio (FaaS) (servicio de función) al almacén, repositorios y varios otros servicios.

  1. En el menú Servicios, vaya a Identidad y seguridad, Identidad y haga clic en Políticas.

  2. Haga clic en Crear política.

  3. Introduzca un nombre y una descripción adecuados y asegúrese de seleccionar el compartimento correcto (en este ejemplo, utilizaremos el compartimento denominado DEV).

  4. En la sección Creador de políticas, asegúrese de activar Mostrar editor manual y agregue las siguientes líneas:

    Allow service faas to read repos in tenancy

Allow service faas to read secret-family in compartment DEV

Allow service faas to read vaults in compartment DEV

Allow service faas to use keys in compartment DEV

Allow service faas to use apm-domains in compartment DEV

Allow dynamic-group DGNAME to read secret-family in compartment DEV

Allow dynamic-group DGNAME to read vaults in compartment DEV

Allow dynamic-group DGNAME to use keys in compartment DEV

    Nota: Sustituya el nombre del grupo dinámico (DGNAME) y el nombre del compartimento (DEV) por los nombres que desee.

  5. Haga clic en Crear.

Tarea 4: Creación de un repositorio para almacenar la función

OCI Container Registry permite almacenar, compartir y gestionar imágenes de contenedor (como las imágenes de Docker) en un registro gestionado por Oracle.

  1. Vaya a la consola de OCI, abra el menú de servicio y haga clic en Developer Services. En Containers, haga clic en Container Registry.

  2. Haga clic en Crear repositorio.

  3. En el cuadro de diálogo Crear repositorio, especifique el compartimento y el nombre del repositorio que desee y déjelo como privado.

  4. Haga clic en Crear repositorio.

Tarea 5: Creación de un almacén para almacenar el usuario y el token de API para la conexión de Jira Service Management

Oracle Cloud Infrastructure Vault es un servicio de gestión de claves que almacena y gestiona claves de cifrado maestras y secretos para acceder de forma segura a los recursos.

  1. Abra el menú de servicio, haga clic en Identidad y seguridad y en Almacén.

  2. Haga clic en Crear almacén.

  3. En el cuadro de diálogo Crear almacén, seleccione el compartimento que desee e introduzca el nombre adecuado que desee. También puedes elegir si quieres hacerlo privado o no.

    Nota: No puede cambiar el tipo de almacén después de crear el almacén.

  4. Cuando termine, haga clic en Crear almacén.

    Nota: Guarde los archivos api-token y api-user de Jira Service Management por separado en el almacén.

Tarea 6: Creación de una aplicación

  1. Abra el menú de servicio y haga clic en Servicios para desarrolladores. En Funciones, haga clic en Aplicaciones.

  2. Haga clic en Crear aplicación.

  3. En la ventana Crear aplicación, introduzca el nombre de la aplicación (por ejemplo, Jira-Ticketing), seleccione la VCN creada en la tarea 1 y seleccione la subred pública.

  4. Haga clic en Crear.

Tarea 7: Despliegue de la función

Esta tarea utilizará el archivo zip que se puede descargar de la sección Prerrequisitos.

  1. Seleccione la aplicación recién creada en la Tarea 6 de la lista.

  2. En las ventanas Aplicación, siga los pasos disponibles en la opción Introducción en Recursos.

    Nota:

    • En este tutorial, utilizamos la configuración de OCI Cloud Shell.

    • En el paso 4 de la configuración, asegúrese de especificar el nombre del repositorio creado en la Tarea 4.

  3. Una vez que haga clic en Iniciar Cloud Shell, se mostrará una nueva ventana de shell pequeño en la parte inferior de la página. En la esquina superior derecha de esa ventana, haga clic en el menú de la rueda dentada y seleccione Upload (Cargar).

  4. Arrastre y suelte el archivo jsm-ticket-function.zip que se cargará en el directorio raíz.

  5. Descomprima el archivo con el siguiente comando.

    unzip jsm-ticket-function.zip

  6. Cambie al directorio de funciones mediante el comando cd jsm-ticket-function y continúe con los pasos descritos en la consola de OCI.

Tarea 8: Edición de la configuración de la función

Las funciones tienen algunos parámetros configurables que se deben editar para que la función funcione correctamente.

  1. En la consola de OCI, vaya a la aplicación creada en la Tarea 6 y seleccione Funciones en la parte izquierda, en Recursos.

  2. Haga clic en el nombre de la función jsm-ticket-function.

  3. Haga clic en Configuración debajo de Recursos. Podrá ver cinco claves: api-token, api-user, service_desk_id, request_type_id y vault_ocid.

    Todas estas claves se deben editar con la configuración:

    • api-token: nombre del secreto del almacén donde se almacena el api-token de la cuenta de usuario de la que se crea el ticket en nombre. Para obtener más información, consulte Gestión de tokens de API para su cuenta de Atlassian.

    • api-user: el nombre del secreto del almacén era la dirección de correo electrónico del usuario de la que se almacenará el ticket en nombre.

    • service_desk_id: proyecto en el que se creará el ticket.

    • request_type_id: tipo de solicitud que el ticket se creará como (debe tener un título y una descripción).

    • vault_ocid: vault_ocid donde se almacenan los secretos de api-token y api-user.

    La forma rápida y sencilla de obtener service_desk_id y request_type_id es visitar el portal que desea utilizar y consultar las URL. Por ejemplo, vaya a un portal y haga clic en una solicitud para emitir y verá una URL como: https://somewhere.atlassian.net/servicedesk/customer/portal/10/group/229/create/664

    Los números que contiene son:

    • 10 - Portal/servicedesk.
    • 229: el grupo por el que entra la solicitud (solo se utiliza en la navegación, no le importa eso en REST).
    • 664: ID del tipo de solicitud en el que he hecho clic.

Tarea 9: Suscripción de la función a un tema

  1. Abra el menú de servicio y haga clic en Servicios para desarrolladores. En Integración de aplicación, haga clic en Notificaciones.

    Nota: Asegúrese de estar en el compartimento correcto.

  2. Haga clic en Crear tema.

  3. Introduzca un nombre adecuado y haga clic en Crear.

  4. Una vez creado el tema, selecciónelo de la lista de temas.

  5. En la ventana Temas, seleccione Suscripciones en la parte izquierda, en Recursos y haga clic en Crear suscripción.

  6. En la ventana Crear suscripción, seleccione el protocolo que desea que sea Funciones, seleccione el compartimento, la aplicación y la función creada en la Tarea 6.

  7. Haga clic en Crear.

Tarea 10: Creación de una alarma para la métrica deseada que necesita supervisar

Puede crear varios tipos de alarmas. En este tutorial, hemos elegido una alarma de ausencia.

  1. Abra el menú de servicio y haga clic en Observación y gestión. En Supervisión, haga clic en Definiciones de alarma.

  2. Haga clic en Crear alarma.

  3. En la página Create Alarm, en Define alarm, introduzca o actualice la configuración de la alarma.

  4. En Definir notificaciones de alarma, asegúrese de seleccionar el tema creado en la tarea 9.

  5. Seleccione el formato de mensaje como Enviar mensajes JSON bonitos (texto raw con saltos de línea).

  6. Haga clic en Guardar alarma.

Agradecimientos

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de formación gratuita en el canal YouTube de Oracle Learning. Además, visita education.oracle.com/learning-explorer para convertirte en un Oracle Learning Explorer.

Para obtener documentación sobre el producto, visite Oracle Help Center.