Instale um pacote npm de um registro privado com o ServiceNow IDE

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura

    • Instale pacotes do Node Package Manager (npm) de um registro privado como dependências em sua aplicação para usá-los como bibliotecas de terceiros.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Para instalar pacotes de registros privados, você deve definir as configurações de usuário do Gerenciador de pacotes no ServiceNow IDE. Em seguida, você pode escolher em quais aplicações instalar pacotes.

    Nota:
    Para instalar pacotes de um registro personalizado, o registro deve responder com o cabeçalho HTTP Access-Control-Allow-Origin.

    Procedimento

    1. Navegar até Tudo > Desenvolvimento de apps > IDE da ServiceNow.
    2. Abra um espaço.
    3. Use um dos seguintes atalhos de teclado para abrir a paleta de comandos:
      • Windows: Ctrl-Shift-P
      • Mac: Cmd-Shift-P
    4. Inserir preferências: abra Configurações do usuário (JSON) e pressione Enter.
    5. Especifique um registro privado como o registro padrão ou um registro com escopo a partir do qual você pode instalar pacotes.
      OpçãoExemplo
      Registro padrão 
      "package-manager.defaultRegistry": "<private-registry-url>",
      Registro com escopo 
      "package-manager.scopedRegistries": [
        {
            "scope": "@<scope>",
            "registry": "<private-registry-url>"
        },
        ...
]
      Nota:
      Para instalar pacotes de registros públicos, você pode especificar um registro público como o registro padrão ou um registro com escopo, além de quaisquer registros privados.
    6. Forneça suas credenciais para acessar o registro privado.
      OpçãoDescrição
      Autenticação básica Forneça um nome de usuário e senha para acessar o registro padrão que você especificou.
      "package-manager.basicAuth": [
    {
        "registry": "<private-registry-url>",
        "user": "<user-name>",
        "pass": "<password>"
    },
    ...
]
      Autenticação legada Forneça um token legado para acessar o registro padrão que você especificou. Tokens legados são credenciais de autenticação básica codificadas no formato Base64.
      "package-manager.legacyAuth": [
    {
        "registry": "<private-registry-url>",
        "token": "<legacy-token>"
    },
    ...
]
      Autenticação do token Forneça um token do portador para acessar o registro padrão que você especificou.
      "package-manager.tokenAuth": [
    {
        "registry": "<private-registry-url>",
        "token": "<token>"
    },
    ...
]
    7. Salve suas mudanças no arquivo Settings.json.
    8. Use um dos seguintes atalhos de teclado para abrir a paleta de comandos:
      • Windows: Ctrl-Shift-P
      • Mac: Cmd-Shift-P
    9. Entre no Gerenciador de pacotes: Instalar dependências e pressione Enter.
    10. Selecione uma aplicação para instalar pacotes como dependências.
      Os pacotes são instalados no diretório node_modules.

    Configurações do usuário para acesso ao registro privado

    No exemplo a seguir, um usuário configurou o acesso a um registro privado usando a autenticação básica. O usuário também definiu suas configurações para instalar pacotes de um registro público com o escopo @example.

    {
    "files.autoSave": "off",
    "package-manager.defaultRegistry": "<private-registry-url>",
    "package-manager.basicAuth": [
        {
        "registry": "<private-registry-url>",
            "user": "<user-name>",
            "pass": "<password>"
        }
    ],
    "package-manager.scopedRegistries": [
        {
            "scope": "@example",
            "registry": "<public-registry-url>"
        }
    ]
}

    O que Fazer Depois

    Use os pacotes que você instalou como bibliotecas de terceiros em sua aplicação. Para obter mais informações, consulte Usar bibliotecas de terceiros em aplicações no ServiceNow IDE.