Limitações de função

• Não há suporte para assinar produtores de eventos
• Nenhum suporte para Terraform.

Como faço para que meu código seja executado como um componente de função Code Engine?

Independentemente de seu código existir como código-fonte em um arquivo local ou em um repositório Git, ou de seu código ser um pacote de código existente localizado em um registro público ou privado, o Code Engine oferece uma maneira simplificada de executar seu código como uma função.

• Se estiver começando com o código-fonte localizado em um repositório Git, você poderá optar por apontar para o local do código-fonte, e o Code Engine se encarregará de criar o pacote de código a partir do código-fonte e de criar a função com uma única operação. Nesse cenário, Code Engine faz o upload de seu código para IBM Cloud® Container Registry. Para saber mais, consulte Criando uma função a partir do código fonte do repositório.

• Se estiver começando com o código-fonte em uma estação de trabalho local, você poderá optar por apontar para o local do código-fonte, e o site Code Engine se encarregará de criar a imagem a partir do código-fonte e de criar a função com um único comando da CLI. Nesse cenário, Code Engine faz o upload de seu código para IBM Cloud® Container Registry. Para saber mais, consulte Criando sua função a partir do código-fonte local com a CLI.

• Se você estiver iniciando com o código-fonte, também será possível executar o código de origem sequencial em linha. Nesse cenário, você cola seu código-fonte ao criar sua função. Para obter mais informações, consulte Criando sua função com código sequencial.

Depois de criar e executar a função, você também pode atualizá-la usando qualquer uma das formas anteriores, independentemente de como criou ou atualizou a função anteriormente.

O que acontece quando eu chamo minha função?

Quando uma função é chamada (iniciada), a instância de Função correspondente é inicializada com o contêiner de Tempo de execução configurado e os parâmetros de Recurso O processo da primeira inicialização é referido como cold start..

Para reduzir a latência de cold start, o Code Engine otimiza a chamada pré-aquecendo determinados tempos de execução com configurações específicas de CPU e memória. As combinações pré-aquecidas para funções incluem os tempos de execução Node.js e Python, bem como a combinação padrão de CPU e memória para funções, que é 0.25 vCPU x 1 GB de memória. Além disso, o sistema é projetado para melhorar a reutilização de instâncias de Função que já estão inicializadas Portanto, uma instância de Função é mantida ativa após a chamada ser concluída para permitir chamadas subsequentes, reutilizando a mesma instância e reutilizando o estado da instância quando a última chamada foi concluída A reutilização de uma instância de Função não é garantida..

Posso manter minha instância de função ativa por mais tempo?

Com o Code Engine, sua função aumenta e para baixo automaticamente, com base na carga de trabalho. Ao criar sua função com a combinação de CPU e memória padrão, sua função é injetada em um contêiner "pré-aquecido", que é otimizado para uso. Ao criar uma função com uma combinação de CPU e memória diferente da combinação padrão, sua função é injetada em um novo contêiner. Por padrão, esse contêiner é mantido ativo por apenas um curto período de tempo após a conclusão da função.. Para obter mais informações, consulte Combinações de CPU e memória suportadas para funções..

É possível mudar a quantia de tempo que seu contêiner é mantido ativo com a opção --scale-down-delay na CLI ou a opção Atraso de Escala no console. Observe que ao manter seu contêiner ativo reduz os horários de cold start para qualquer execução subsequente de sua função, você também é cobrado pela quantia de tempo que o contêiner de função customizada existe.

Solicitações e respostas

As funções são invocadas com o protocolo HTTP. Ao invocar a função, você pode especificar os parâmetros da solicitação personalizada, o corpo e os cabeçalhos da solicitação personalizada, bem como o método HTTP. Os parâmetros de solicitação são disponibilizados para o código de função como parâmetros de entrada O código de função pode configurar o corpo de resposta, cabeçalhos de resposta e código de resposta, que são retornados para o responsável pela chamada a partir do terminal de funções.

  function main(params) {
      var msg = 'You did not tell me who you are.';
      if (params.name) {
          msg = `Hello, ${params.name}!`
       } else {
          msg = `Hello, FaaS on CodeEngine!`
      }
      return {
          headers: { 'Content-Type': 'text/html; charset=utf-8' },
          body: `<html><body><h3>${msg}</h3></body></html>`
       }
  }

  module.exports.main = main;

function main(params) {
    return {
        headers: { location: 'https://cloud.ibm.com/docs/codeengine' },
        statusCode: 302
    }
}

function main(params) {
    var msg = 'You did not tell me who you are.';
    if (params.name !== "") {
        msg = `Hello, ${params.name}!`
    }
    return {
        headers: { 'Content-Type': 'text/plain;charset=utf-8' },
        body: `${msg}`
    }
}

Manipulação de erros e depuração

Chamadas de função podem retornar erros do sistema ou do aplicativo. Por exemplo, erros do sistema indicam que o código de função não foi executado com êxito, enquanto erros do aplicativo indicam um problema no próprio código de função.

Quando ocorre um erro de sistema, é retornado um código de resposta HTTP semelhante aos códigos a seguir.

Se Code Engine puder executar o código de funções, ele responderá à chamada com um dos seguintes códigos de status.

Como desenvolvedor de uma função, você pode gerar qualquer código de status HTTP arbitrário, mesmo os listados anteriormente. Portanto, um cabeçalho de resposta indica que o código de status foi gerado pelo código de função.

As funções Code Engine incluem os cabeçalhos de resposta a seguir na resposta de chamada de função.

Características de entrada / saída de dados de função

Para executar sua função no Code Engine, seu código deve implementar um contrato de tempo de execução com as características a seguir.

• Deve ser chamável a partir de um endpoint de aplicativo da Web público, para que possa ser incorporado a páginas da Web e, em seguida, invocado a partir de qualquer fonte de eventos Code Engine, um navegador da Web ou qualquer outro cliente compatível com HTTPS.
• Deve implementar um procedimento main como ponto de entrada. O procedimento main pode receber parâmetros de entrada no formato de uma estrutura de dados formatada JSON e pode retornar parâmetros de saída, também no formato de uma estrutura de dados formatada JSON.
• Pode receber um subcaminho opcional para que a função possa implementar diferentes tipos, com base no caminho especificado. O procedimento main da função recebe o caminho como um parâmetro de entrada __ce_path
• Pode receber parâmetros de consulta opcionais, que podem ser usados para configurar a função no tempo de execução O procedimento main da função recebe os parâmetros como pares de valores de chave dentro da estrutura de dados de entrada formatada JSON
• Pode receber cabeçalhos de solicitação para que o código do cliente possa especificar codificações aceitas.
• É possível receber um cabeçalho de solicitação de tipo de conteúdo opcional
• É possível receber uma carga útil de solicitação opcional (corpo), que a função processa no tempo de execução Dependendo do tipo de conteúdo de solicitação selecionado, a carga útil de dados é transmitida para o ponto de entrada principal da função, seja no formato codificado de base 64 ou "desdobrado" como parte da estrutura de dados de entrada JSON. Caracteres especiais em pares de valores de chaves de entrada application/x-www-form-urlencoded são valores percent-encoded.
• Pode definir um código de status HTTP arbitrário (opcional) que é então retornado ao cliente que o invoca.
• É possível configurar cabeçalhos de resposta arbitrários, como um local de redirecionamento, uma codificação de resposta ou valores de cookie
• Pode retornar um corpo de resposta arbitrária com uma codificação binária ou não binária selecionada; por exemplo, application/octet-stream, application/json, text/*, image/* ou audio/* Se nenhum cabeçalho de resposta content-type for configurado, ele será padronizado para text/plain..
• Suporta os seguintes tipos de conteúdo de solicitação: application/x-www-form-urlencoded (padrão), text/plain, application/json, application/octet-stream, image/*, audio/*
• Não suporta o cabeçalho da Solicitação multipart/form-data

Opções de visibilidade para uma função Code Engine

Com o site Code Engine, você pode determinar o nível certo de visibilidade para a sua função, definindo os pontos de extremidade ou mapeamentos de domínio do sistema que estão disponíveis para receber solicitações.

Cada função tem um mapeamento interno do domínio do sistema que é visível para todos os componentes dentro do mesmo projeto Code Engine, mas não fora do projeto. Além do mapeamento de domínio do sistema interno, você escolhe tornar a função visível para a internet pública ou para a rede IBM Cloud privada.

Para visibilidade pública ou privada, a função é exposta em um ponto de extremidade HTTPS. Para obter detalhes sobre o certificado TLS que é usado, consulte Certificados TLS para projetos Code Engine.

É possível implementar sua função com os níveis de visibilidade a seguir:

É possível definir as configurações de endpoint para a visibilidade de uma função no console ou com a CLI ao criar e implantar ou atualizar a função.

Opções para criar funções

Saiba mais sobre as opções que você pode especificar ao criar sua função. Observe que as opções podem variar entre o console e a CLI.

Considerações para Cotas de Funções

Ao trabalhar com aplicativos, funções e tarefas em lote, esses recursos são executados no contexto de um projeto do Code Engine. As cotas de recursos são definidas por projeto e os limites se aplicam a aplicativos, funções e tarefas em lote.

Para obter mais informações sobre limites do Code Engine, consulte Limites e cotas para o Code Engine.

Próximas etapas

Agora que você está familiarizado com os conceitos-chave de trabalho com as funções Code Engine, está pronto para criar e trabalhar com as funções? Consulte os tópicos a seguir.

• Criando cargas de trabalho de função com código sequencial.
• Criando cargas de trabalho de função com código-fonte do repositório.
• Criando cargas de trabalho de função a partir do código fonte local.

Para obter mais informações sobre como trabalhar com funções, consulte os tópicos a seguir.

• Cargas de trabalho de função.
• Integrando serviços do IBM Cloud com ligações de serviço.
• Trabalhando com variáveis de ambiente, configmaps e secrets.
• Funções de resolução de problemas