Documentação do Oracle Cloud Infrastructure

Visão Geral do Serviço Events

Crie automação com base nas alterações de estado dos recursos em toda a sua tenancy.

O Oracle Cloud Infrastructure Events permite criar automação com base nas alterações de estado dos recursos em toda a tenancy. Use o serviço Events para permitir que suas equipes de desenvolvimento respondam automaticamente quando um recurso alterar seu estado.

Estes são alguns exemplos de ações que você pode executar com o serviço Events:

  • Enviar uma notificação para uma equipe de DevOps quando um backup do banco de dados for concluído.
  • Converter os arquivos de um formato em outro quando forem submetidos a upload em um bucket do serviço Object Storage.

Como o Serviço Events Funciona

Os serviços do Oracle Cloud Infrastructure emitem eventos, que são mensagens estruturadas que indicam alterações em recursos. Os eventos (as mensagens, não o serviço) seguem o formato padrão do setor CloudEvents hospedado pela Cloud Native Computing Foundation (CNCF). Esse padrão permite interoperabilidade entre vários provedores de nuvem ou sistemas locais e provedores de nuvem. Um evento pode ser uma operação de criação, leitura, atualização ou exclusão (CRUD), uma alteração no estado do ciclo de vida de um recurso ou um evento do sistema que afete um recurso. Por exemplo, um evento poderá ser emitido quando um backup for concluído ou falhar, ou um arquivo em um bucket do serviço Object Storage for adicionado, atualizado ou excluído.

Os serviços emitem eventos para recursos ou dados. Por exemplo, o serviço Object Storage emite eventos para buckets e objetos. Os serviços emitem diversos tipos de eventos para recursos, que são diferenciados como tipos de eventos. Buckets e objetos têm tipos de eventos de criação, atualização e exclusão, por exemplo. Os tipos de evento são as alterações que produzem eventos por um determinado recurso. Para obter uma lista de serviços que produzem eventos e os tipos de evento que esses serviços rastreiam, consulte Serviços que Produzem Eventos.

Você trabalha com eventos criando regras. As regras incluem um filtro que você define para especificar eventos produzidos pelos recursos na sua tenancy. O filtro é flexível:

  • Você pode definir filtros que correspondam apenas a determinados eventos ou a todos os eventos.
  • Você pode definir filtros com base na forma como os recursos são marcados ou na presença de valores específicos em atributos do próprio evento.

As regras também devem especificar uma ação a ser acionada quando o filtro localizar um evento correspondente. Ações são respostas que você define para correspondências de evento. Você configura serviços selecionados do Oracle Cloud Infrastructure que o serviço Events estabeleceu como ações (veja mais adiante informações sobre esses serviços selecionados). Os recursos desses serviços atuam como destinos para eventos correspondentes. Quando o filtro na regra localiza uma correspondência, o serviço Events envia o evento de correspondência para um ou mais destinos identificados na regra. O serviço de destino que recebe o evento, então, processa o evento da maneira que você definiu. Essa entrega fornece a automação no seu ambiente.

Você só pode entregar eventos a determinados serviços do Oracle Cloud Infrastructure com uma regra. Use os seguintes serviços para criar ações: 

Um diagrama do serviço Events

Conceitos do Serviço Events

Os conceitos a seguir são essenciais para trabalhar com o serviço Events.

EVENTOS
Uma notificação automática de uma alteração de estado conforme reportado por um recurso do Oracle Cloud Infrastructure emissor de eventos. Por exemplo, um recurso de banco de dados emite um evento backup.begin quando um backup é iniciado.
TIPOS DE EVENTO
Uma distinção entre os diversos tipos de eventos. Para obter mais informações, consulte Serviços que Produzem Eventos.
REGRAS
Um objeto JSON criado para se inscrever em um tipo de evento e acionar uma ação, caso esse evento ocorra. Por exemplo, uma regra pode especificar que os tipos de evento backup.end de bancos de dados acionam o serviço Notifications para enviar um e-mail a um engenheiro DevOps específico. Para obter mais informações, consulte Fazendo Correspondência de Eventos com Filtros.
AÇÕES
As regras também devem especificar uma ação a ser acionada quando o filtro localizar um evento correspondente. Ações são respostas que você define para correspondências de evento. Você configura serviços selecionados do Oracle Cloud Infrastructure que o serviço Events estabeleceu como ações. Os recursos desses serviços atuam como destinos para eventos correspondentes. Quando o filtro na regra localiza uma correspondência, o serviço Events envia o evento de correspondência para um ou mais destinos identificados na regra. O serviço de destino que recebe o evento, então, processa o evento da maneira que você definiu. Essa entrega fornece a automação no seu ambiente.
Você só pode entregar eventos a determinados serviços do Oracle Cloud Infrastructure com uma regra. Use os seguintes serviços para criar ações: 

Formas de Acessar o Oracle Cloud Infrastructure

Você pode acessar o OCI (Oracle Cloud Infrastructure) usando a Console (uma interface baseada em browser), a API REST ou a CLI do OCI. Instruções para usar a Console, API e CLI nos tópicos ao longo desta documentação. Para ver uma lista de SDKs disponíveis, consulte Software Development Kits e Interface de Linha de Comando.

Para acessar a Console, você deve usar um browser suportado. Para ir até a página de acesso da Console, abra o menu de navegação na parte superior desta página e selecione Console de Infraestrutura. Você é solicitado a digitar seu tenant na nuvem, seu nome de usuário e sua senha.

Autenticação e Autorização

Cada serviço do Oracle Cloud Infrastructure se integra ao serviço IAM para autenticação e autorização, para todas as interfaces (a Console, SDK ou CLI e API REST).

Um administrador de uma organização precisa configurar grupos, compartimentos e políticas que controlam quais usuários podem acessar quais serviços, quais recursos e o tipo de acesso. Por exemplo, as políticas controlam quem pode criar novos usuários, criar e gerenciar a rede na nuvem, criar instâncias, criar buckets, fazer download dos objetos, entre outros. Para obter mais informações, consulte Gerenciando Domínios de Identidade. Para ver detalhes específicos sobre a gravação de políticas para cada um dos diversos serviços, consulte Referência de Políticas.

Se você for um usuário comum (não um administrador) que precisa usar os recursos do Oracle Cloud Infrastructure que a empresa possui, entre em contato com um administrador para configurar um ID de usuário para você. O administrador pode confirmar o(s) compartimento(s) que você pode usar.

Administradores: Você devem gravar a política do serviço IAM que permita aos usuários trabalhar com regras. Para obter mais informações, consulte Serviço Events e Políticas do Serviço IAM.

Gateway de Serviço e Serviço Events

O serviço Events também suporta acesso privado de recursos do Oracle Cloud Infrastructure em uma VCN por meio de um gateway de serviço . Um gateway de serviço permite a conectividade com os pontos finais públicos do Events de endereços IP privados em sub-redes privadas. Por exemplo, você pode gerenciar regras pelo backbone do Oracle Cloud Infrastructure em vez da Internet. Opcionalmente, você pode usar políticas do serviço IAM para controlar quais VCNs ou faixas de endereços IP podem acessar o serviço Events. Consulte Acesso aos Serviços Oracle: Gateway de Serviço para obter detalhes.