{"meta":{"title":"pack add","intro":"Adiciona uma lista de pacotes de biblioteca QL com intervalos de versão opcionais como dependências do pacote atual e os instala.","product":"Qualidade de segurança e código","breadcrumbs":[{"href":"/pt/code-security","title":"Qualidade de segurança e código"},{"href":"/pt/code-security/reference","title":"Referência"},{"href":"/pt/code-security/reference/code-scanning","title":"Varredura de código"},{"href":"/pt/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"Manual da CLI do CodeQL"},{"href":"/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual/pack-add","title":"pack add"}],"documentType":"article"},"body":"# pack add\n\nAdiciona uma lista de pacotes de biblioteca QL com intervalos de versão opcionais como dependências do pacote atual e os instala.\n\n> [!NOTE]\n> Este conteúdo descreve a versão mais recente do CodeQL CLI. Para obter mais informações sobre essa versão, confira https://github.com/github/codeql-cli-binaries/releases.\n>\n> Para ver os detalhes das opções disponíveis para esse comando em uma versão anterior, execute o comando com a opção <span style=\"white-space: nowrap;\">`--help`</span> no terminal.\n\n## Sinopse\n\n```shell copy\ncodeql pack add <options>... -- <scope/name[@range]>...\n```\n\n## Description\n\nAdiciona uma lista de pacotes de biblioteca QL com intervalos de versão opcionais como dependências do pacote atual e os instala.\n\nEsse comando modifica o arquivo qlpack.yml do pacote atual.\nA formatação e os comentários serão removidos.\n\nDisponível desde `v2.6.0`.\n\n## Opções\n\n### Opções principais\n\n#### `<scope/name[@range]>...`\n\n\\[Obrigatório] O escopo, o nome e o intervalo de versão opcional do pacote a ser adicionado à lista de dependências.\n\nSe nenhum intervalo de versão for especificado ou se o intervalo de versão for especificado como 'mais recente', a versão mais recente do pacote será baixada e uma dependência será adicionada a qlpack.yml que permite qualquer versão compatível com a versão baixada.\n\nSe uma única versão for especificada, essa versão do pacote será baixada e uma dependência será adicionada ao qlpack.yml, que permite qualquer versão que seja compatível com a versão especificada.\n\nSe um intervalo de versão for especificado, a versão mais recente do pacote que satisfaça o intervalo especificado será baixada e uma dependência será adicionada a qlpack.yml com o intervalo de versão especificado.\n\n#### `--dir=<dir>`\n\nO diretório raiz do pacote.\n\n#### `--registries-auth-stdin`\n\nAutentique-se nos registros de contêiner do GitHub Enterprise Server transmitindo uma lista separada por vírgula de pares \\<registry\\_url>=\\<token>.\n\nPor exemplo, você pode transmitir `https://containers.GHEHOSTNAME1/v2/=TOKEN1,https://containers.GHEHOSTNAME2/v2/=TOKEN2`\npara se autenticar em duas instâncias do GitHub Enterprise Server.\n\nIsso substitui as variáveis de ambiente CODEQL\\_REGISTRIES\\_AUTH e GITHUB\\_TOKEN. Se você só precisar se autenticar no registro de contêiner do github.com, poderá se autenticar usando a opção `--github-auth-stdin` mais simples.\n\n#### `--github-auth-stdin`\n\nAutentique-se no registro de contêiner do github.com transmitindo um token do GitHub Apps do github.com ou um token de acesso pessoal por meio da entrada padrão.\n\nPara se autenticar nos registros de contêiner do GitHub Enterprise Server, transmita `--registries-auth-stdin` ou use a variável de ambiente CODEQL\\_REGISTRIES\\_AUTH.\n\nIsso substitui a variável de ambiente GITHUB\\_TOKEN.\n\n#### `--[no-]allow-prerelease`\n\nPermita o uso de pacotes com qualificadores de versão de pré-lançamento (por exemplo, `X.Y.Z-qualifier`). Sem esse sinalizador, os pacotes de pré-lançamento serão ignorados.\n\nDisponível desde `v2.11.3`.\n\n### Opções comuns\n\n#### `-h, --help`\n\nMostre este texto de ajuda.\n\n#### `-J=<opt>`\n\n\\[Avançado] Forneça a opção para a JVM que executa o comando.\n\n(Use-a com cautela, pois as opções que contêm espaços não serão tratadas corretamente.)\n\n#### `-v, --verbose`\n\nAumente incrementalmente o número de mensagens de progresso impressas.\n\n#### `-q, --quiet`\n\nDiminua incrementalmente o número de mensagens de progresso impressas.\n\n#### `--verbosity=<level>`\n\n\\[Avançado] Defina explicitamente o nível de detalhamento como erros, avisos, progresso, progresso+, progresso++ ou progresso+++. Substitui `-v` e `-q`.\n\n#### `--logdir=<dir>`\n\n\\[Avançado] Escreva logs detalhados em um ou mais arquivos no diretório fornecido, com nomes gerados que incluem carimbos de data/hora e o nome do subcomando em execução.\n\n(Para gravar um arquivo de log com um nome sobre o qual você tem controle completo, forneça `--log-to-stderr` e redirecione stderr conforme desejado.)\n\n#### `--common-caches=<dir>`\n\n\\[Avançado] Controle a localização dos dados armazenados em cache no disco que persistirão entre várias execuções da CLI, como pacotes QL baixados e planos de consulta compilada. Se não for definido explicitamente, o padrão corresponde a um diretório intitulado `.codeql` no diretório inicial do usuário; que será criado se ainda não existir.\n\nDisponível desde `v2.15.2`."}