Todos os produtos
Search
Central de documentação

Function Compute:Implante um pacote de código

Última atualização: Sep 21, 2026

Este tópico descreve como instalar dependências de terceiros para seu código Node.js, empacotar o código e fazer o deploy no Function Compute. Como exemplo, utilizamos uma biblioteca de dependências de emojis de terceiros.

Preparativos

  1. Crie um diretório de código para testes e especifique um nome para o diretório. Neste exemplo, usamos mycode.

    • Linux e macOS

      Execute o comando mkdir -p /tmp/mycode para criar o diretório.

    • Windows

      Crie uma pasta e nomeie-a como mycode.

  2. Crie o arquivo index.mjs ou index.js no diretório mycode.

    O código a seguir mostra um exemplo:

    Módulos ECMAScript

    Nota

    Este exemplo oferece suporte apenas ao Node.js 18 ou superior.

    // index.mjs
    'use strict';
    import * as emoji from 'node-emoji'
    
    export const handler = async (event, context) => {
      console.log('hello world');
      return emoji.get(':unicorn:');
    }
    

    Módulos CommonJS

    // index.js
    'use strict';
    var emoji = require('node-emoji')
    
    exports.handler = (event, context, callback) => {
      console.log('hello world');
      callback(null, emoji.get(':unicorn:'));
    }
    

Use o npm para instalar dependências e fazer o deploy do código

Prerequisites

  • O npm está instalado na sua máquina local e você possui as permissões para executar comandos do npm.

  • Você criou uma função Node.js no console do Function Compute. Para mais informações, consulte {{XREF_0}}.

Procedure

  1. Execute o comando npm install node-emoji no diretório mycode e instale a biblioteca de dependências de emojis no diretório atual.

  2. Empacote todos os arquivos no diretório mycode.

    • Linux e macOS

      Acesse o diretório mycode e execute zip code.zip -r ./*.

      Nota

      Certifique-se de ter as permissões de leitura e gravação no diretório.

    • Windows

      Acesse o diretório mycode, selecione todos os arquivos, clique com o botão direito neles e compacte-os em um arquivo .zip.

    Nota

    Certifique-se de que o arquivo index.js criado esteja localizado no diretório raiz do pacote.

  3. No console do Function Compute, encontre a função que você deseja gerenciar. No canto superior direito da página de detalhes da função, clique em Upload Code e faça o upload do pacote ZIP preparado.

    Após o upload do código, clique em Test Function na aba Code para verificar se o código está correto.

Importante

O Function Compute é executado em um ambiente Linux. Se um arquivo binário for incluído ao instalar a biblioteca de dependências de emojis em um dispositivo Windows ou macOS, o pacote de código falhará na execução. Portanto, recomendamos usar o WebIDE para empacotar dependências de terceiros ou usar o Serverless Devs para instalar dependências e implantar o projeto. Para mais informações, consulte {{XREF_1}} e {{XREF_2}}.

Use o Serverless Devs para instalar dependências e fazer o deploy do código

Prerequisites

  • O Serverless Devs e as dependências estão instalados. Para mais informações, consulte {{XREF_3}}.

  • O Serverless Devs está configurado. Para mais informações, consulte {{XREF_4}}.

Procedure

  1. Execute o comando cd /tmp/mycode para acessar o diretório mycode.

  2. Crie o arquivo s.yaml.

    O código de exemplo a seguir mostra como editar o arquivo:

    edition: 3.0.0
    name: fcDeployApp
    access: "default"
    
    vars: # The global variables.
      region: "cn-hangzhou"
    
    resources:
      hello_world:
        component: fc3 # The name of the component.
        props:
          region: ${vars.region}              # For information about how to use variables, visit: https://docs.serverless-devs.com/serverless-devs/yaml#%E5%8F%98%E9%87%8F%E8%B5%8B%E5%80%BC.
          functionName: "emoji"
          description: 'this is emoji'
          runtime: "nodejs18"
          code: ./
          handler: index.handler
          memorySize: 128
          timeout: 30
  3. Adicione o arquivo package.json.

    O código de exemplo a seguir mostra como editar o arquivo:

    {
      "dependencies": {
        "node-emoji": "^1.11.0"
      }
    }
  4. Execute sudo s build --use-docker para instalar as dependências.

    Após a conclusão da execução, o diretório .s é gerado no diretório mycode, e as dependências são instaladas no diretório .s/build/artifacts/{functionName}.

  5. Execute sudo s deploy para fazer o deploy do projeto.

    Após a execução, você pode implantar sua função no Function Compute.

Nota importante

Ao usar um runtime personalizado para Node.js e especificar um executável compilado como comando de inicialização, a modificação do código-fonte diretamente no WebIDE não terá efeito, pois a função continuará a executar o binário compilado anteriormente. Para aplicar alterações no código, atualize o código-fonte localmente, recompile e empacote o executável, faça o upload do pacote atualizado para o WebIDE e execute a função novamente.

Mais informações

Se o seu pacote de código for muito grande, separe as dependências, crie uma camada e faça o upload apenas do código de negócio. Para mais informações, consulte os seguintes tópicos: