Documentação do Oracle Cloud Infrastructure

Criando Aplicativos

Descubra como criar aplicativos com o OCI Functions.

No serviço OCI Functions, um aplicativo é um agrupamento lógico de funções. As propriedades especificadas para um aplicativo determinam a alocação de recursos e a configuração de todas as funções desse aplicativo. Você precisa criar uma função em um aplicativo; portanto, deve existir pelo menos um aplicativo para que você possa criar uma função no OCI Functions.

Para obter mais informações sobre aplicativos, consulte Aplicativos.

    1. Confirme se você concluiu as etapas nos Guias do FunctionsQuickStart.
    2. Na página da lista Aplicativos, selecione o compartimento especificado no contexto da CLI do Fn Project (consulte Criando um Contexto da CLI do Fn Project para Conectar ao Oracle Cloud Infrastructure). Se precisar de ajuda para localizar a página da lista, consulte Listando Aplicativos.

    3. Selecione Criar Aplicativo e especifique os seguintes detalhes:

      • Nome: Um nome para o novo aplicativo (por exemplo, acmeapp. Evite digitar informações confidenciais.
      • Compartimento da VCN: O compartimento que contém a VCN (rede virtual na nuvem) na qual executar funções.
      • VCN: A VCN (rede virtual na nuvem) na qual executar funções. Por exemplo, uma VCN chamada acme-vcn-01
      • Compartimento de sub-redes: O compartimento que contém a sub-rede (ou sub-redes) na qual executar funções.
      • Sub-redes no <compartment-name>: A sub-rede (ou sub-redes, até no máximo três) na qual executar funções. Por exemplo, uma sub-rede pública chamada Public Subnet IHsY:US-PHOENIX-AD-1.

        Uma sub-rede pública requer um gateway de internet na VCN, e uma sub-rede privada requer um gateway de serviço na VCN. Se uma sub-rede regional tiver sido definida, como prática recomendada, selecione essa sub-rede para facilitar a implementação de failover entre domínios de disponibilidade. Se uma sub-rede regional não tiver sido definida e você precisar atender aos requisitos de alta disponibilidade, selecione várias sub-redes. Recomendamos que as sub-redes estejam na mesma região que o registro do Docker especificado no contexto da CLI do Fn Project. Para obter mais informações, consulte Criando um Contexto da CLI do Fn Project para Conexão com o Oracle Cloud Infrastructure.

        A especificação de uma sub-rede privada para um aplicativo não impede o acesso da internet aos pontos finais de chamada de funções no aplicativo. Use políticas de identidade para controlar o acesso para chamar pontos finais de função. Para obter detalhes, consulte Controlando o Acesso a Funções de Chamada e Gerenciamento.

      • Forma: A arquitetura do processador das instâncias de computação nas quais implantar e executar funções no aplicativo. Todas as funções no aplicativo são implantadas e executadas em instâncias de computação com a mesma arquitetura. A imagem da função deve conter as dependências necessárias para a arquitetura selecionada, da seguinte forma:

        • Selecione a forma Generic_ARM se você sempre quiser que as funções no aplicativo sejam executadas em instâncias de computação com uma arquitetura baseada em Arm. Se você selecionar essa forma de arquitetura única para o aplicativo, a imagem da função deverá conter as dependências necessárias para a arquitetura Arm (em uma única imagem de arquitetura ou em uma imagem de várias arquiteturas).
        • Selecione a forma Generic_X86 se você sempre quiser que as funções no aplicativo sejam executadas em instâncias de computação com uma arquitetura baseada em x86. Se você selecionar essa forma de arquitetura única para o aplicativo, a imagem da função deverá conter as dependências necessárias para a arquitetura x86 (em uma única imagem de arquitetura ou em uma imagem de várias arquiteturas).
        • Selecione a forma Generic_X86_ARM se quiser que as funções sejam executadas em instâncias de computação com qualquer arquitetura que tenha capacidade suficiente. Nesse caso, o OCI Functions seleciona a arquitetura na qual executar funções com base na capacidade disponível. Se você selecionar essa forma de várias arquiteturas para o aplicativo, a imagem de cada função deverá conter as dependências necessárias para a arquitetura Arm e a arquitetura x86 (em uma imagem de várias arquiteturas).

        Observe que você não pode alterar a forma do aplicativo depois de criar o aplicativo. Consulte Selecionando uma Única Arquitetura ou Forma de Aplicativo de Várias Arquiteturas na qual executar uma Função.

      • Tags: Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.

    4. Selecione uma das seguintes opções:

      • Para criar o aplicativo agora, selecione Criar. O novo aplicativo aparece na lista de aplicativos.
      • Para criar o aplicativo posteriormente usando o Resource Manager e o Terraform, selecione Salvar como pilha para salvar a definição de recurso como uma configuração do Terraform. Para obter mais informações sobre como salvar pilhas de definições de recursos, consulte Criando uma Pilha de uma Página de Criação de Recurso.

  • Usando a CLI do Fn Project

    Dica

    De tempos em tempos, novas versões da CLI do Fn Project são lançadas. Recomendamos que você verifique regularmente se a versão mais recente está instalada. Para obter mais informações, consulte Etapas para fazer upgrade da CLI do Fn Project.

    Para criar um novo aplicativo no OCI Functions usando a CLI do Fn Project:

    1. Acesse o ambiente de desenvolvimento como desenvolvedor de funções.

    2. Em uma janela de terminal, crie um novo aplicativo informando:

      fn create app <app-name> --annotation oracle.com/oci/subnetIds='["<subnet-ocid>"]'

      em que:

      • <app-name> é o nome do novo aplicativo. Evite digitar informações confidenciais.
      • <subnet-ocid> é o OCID da sub-rede (ou sub-redes, até no máximo três) na qual executar funções. Observe que uma sub-rede pública requer um gateway de internet na VCN e uma sub-rede privada requer um gateway de serviço na VCN. Se uma sub-rede regional tiver sido definida, a prática recomendada é selecionar essa sub-rede para tornar o failover entre os domínios de disponibilidade mais simples de implementação. Se uma sub-rede regional não tiver sido definida e você precisar atender aos requisitos de alta disponibilidade, especifique várias sub-redes (coloque cada OCID entre aspas duplas separadas por vírgulas, no formato '["<subnet-ocid>","<subnet-ocid>"]'). O sistema Oracle recomenda que as sub-redes estejam na mesma região que o registro Docker especificado no contexto da CLI do Fn Project (consulte Criando um Contexto da CLI do Fn Project para Conexão com o Oracle Cloud Infrastructure).

        Observe que a especificação de uma sub-rede privada para um aplicativo não impede o acesso da internet aos pontos finais de chamada de funções no aplicativo. Use políticas de identidade para controlar o acesso a pontos finais de chamada de função (consulte Controlando o Acesso para Chamar e Gerenciar Funções).

      Por exemplo:

      fn create app acmeapp --annotation oracle.com/oci/subnetIds='["ocid1.subnet.oc1.phx.aaaaaaaacnh..."]'

      Um aplicativo é criado no OCI Functions, na tenancy e na região implícita pelo OCID da sub-rede e que pertence ao compartimento especificado no arquivo de contexto da CLI do Fn Project.

    3. Verifique se o novo aplicativo foi criado informando:

      fn list apps

      Por exemplo:

      $ fn list apps
                        
acmeapp

    Usando a CLI do OCI

    Use o comando oci fn application create e os parâmetros necessários para criar um aplicativo:

    oci fn application create --compartment-id <compartment-ocid> --display-name <app-name> --subnet-ids <subnet-ocids> [OPTIONS]

    Para obter uma lista completa de flags e opções de variáveis para comandos da CLI do OCI, consulte a Referência de Linha de Comando.

  • Execute a operação de API CreateApplication para criar um aplicativo.