{"meta":{"title":"Argumentos e configurações complementares","intro":"GitHub Actions Importer tem vários argumentos e configurações complementares para adaptar o processo de migração às suas necessidades.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/actions","title":"GitHub Actions"},{"href":"/pt/actions/reference","title":"Referência"},{"href":"/pt/actions/reference/github-actions-importer","title":"Importador de Ações do GitHub"},{"href":"/pt/actions/reference/github-actions-importer/supplemental-arguments-and-settings","title":"Argumentos e configurações complementares"}],"documentType":"article"},"body":"# Argumentos e configurações complementares\n\nGitHub Actions Importer tem vários argumentos e configurações complementares para adaptar o processo de migração às suas necessidades.\n\nEste artigo fornece informações gerais para configurar GitHub Actions Importerargumentos e configurações complementares, como parâmetros opcionais, argumentos de caminho e configurações de rede.\n\n## Parâmetros opcionais\n\nGitHub Actions Importer tem vários parâmetros opcionais que você pode usar para personalizar o processo de migração.\n\n### Como limitar ações permitidas\n\nAs opções a seguir podem ser usadas para limitar quais ações são permitidas em fluxos de trabalho convertidos. Quando usadas em combinação, essas opções expandem a lista de ações permitidas. Se nenhuma dessas opções for fornecida, todas as ações serão permitidas.\n\n* `--allowed-actions` especifica uma lista de ações que serão permitidas em fluxos de trabalho convertidos. Os caracteres curinga têm suporte. Quaisquer outras ações diferentes das fornecidas não serão permitidas.\n\n  Por exemplo:\n\n  ```shell\n  --allowed-actions actions/checkout@v6 actions/upload-artifact@* my-org/*\n  ```\n\n  Você pode fornecer uma lista vazia a fim de bloquear qualquer ação. Por exemplo, `--allowed-actions=`.\n\n* `--allow-verified-actions` especifica que todas as ações de criadores verificados são permitidas.\n\n* `--allow-github-created-actions` especifica que as ações publicadas das organizações `github`ou `actions` são permitidas.\n\n  Por exemplo, essas ações incluem `github/super-linter` e `actions/checkout`.\n\n  Essa opção é equivalente a `--allowed-actions actions/* github/*`.\n\n### Usando um arquivo de credenciais de autenticação\n\nO `--credentials-file` parâmetro especifica o caminho para um arquivo que contém credenciais para servidores diferentes que GitHub Actions Importer podem se autenticar. Isso é útil quando scripts de build (como `.travis.yml` ou `jenkinsfile`) são armazenados em várias GitHub Enterprise Server instâncias.\n\nUm arquivo de credenciais deve ser um YAML e conter uma lista de combinações de servidor e token de acesso. \nGitHub Actions Importer usa as credenciais para a URL que corresponde mais de perto à solicitação de rede que está sendo feita.\n\nPor exemplo:\n\n```yaml\n- url: https://github.com\n  access_token: ghp_mygeneraltoken\n- url: https://github.com/specific_org/\n  access_token: ghp_myorgspecifictoken\n- url: https://jenkins.org\n  access_token: abc123\n  username: marty_mcfly\n```\n\nPara o arquivo de credenciais acima, GitHub Actions Importer usa o token `ghp_mygeneraltoken` de acesso para autenticar todas as solicitações `https://github.com`de rede, _a menos que_ a solicitação de rede seja para um repositório na `specific_org` organização. Nesse caso, o token `ghp_myorgspecifictoken` é usado para autenticar.\n\n#### Provedores alternativos de código-fonte\n\nGitHub Actions Importer pode buscar automaticamente o código-fonteGitHub de não repositórios. Um arquivo de credenciais pode especificar o `provider`, a URL do provedor e as credenciais necessárias para recuperar o código-fonte.\n\nPor exemplo:\n\n```yaml\n- url: https://gitlab.com\n  access_token: super_secret_token\n  provider: gitlab\n```\n\nPara o exemplo acima, GitHub Actions Importer usa o token `super_secret_token` para recuperar qualquer código-fonte hospedado.`https://gitlab.com`\n\nOs valores com suporte para `provider` são:\n\n* `github` (padrão)\n* `gitlab`\n* `bitbucket_server`\n* `azure_devops`\n\n### Como controlar recursos opcionais\n\nVocê pode usar a opção `--features` para limitar os recursos usados em fluxos de trabalho que GitHub Actions Importer criam. Isso é útil para excluir a sintaxe mais GitHub Actions recente dos fluxos de trabalho ao migrar para uma instância mais antiga GitHub Enterprise Server . Ao usar a opção `--features` , você deve especificar a versão para GitHub Enterprise Server a qual está migrando.\n\nPor exemplo:\n\n```shell\ngh actions-importer dry-run ... --features ghes-3.3\n```\n\nOs valores com suporte para `--features` são:\n\n* `all` (valor padrão)\n* `ghes-latest`\n* `ghes-<number>`, onde `<number>` está a versão de GitHub Enterprise Server, `3.0` ou posterior. Por exemplo, `ghes-3.3`.\n\nVocê pode exibir a lista de sinalizadores GitHub Actions Importer de recursos disponíveis executando o `list-features` comando. Por exemplo:\n\n```shell copy\ngh actions-importer list-features\n```\n\nVocê deverá ver um resultado semelhante ao seguinte.\n\n<!-- markdownlint-disable search-replace -->\n\n```shell\nAvailable feature flags:\n\nactions/cache (disabled):\n        Control usage of actions/cache inside of workflows. Outputs a comment if not enabled.\n        GitHub Enterprise Server >= ghes-3.5 required.\n\ncomposite-actions (enabled):\n        Minimizes resulting workflow complexity through the use of composite actions. See https://docs.github.com/en/actions/creating-actions/creating-a-composite-action for more information.\n        GitHub Enterprise Server >= ghes-3.4 required.\n\nreusable-workflows (disabled):\n        Avoid duplication by re-using existing workflows. See https://docs.github.com/en/actions/using-workflows/reusing-workflows for more information.\n        GitHub Enterprise Server >= ghes-3.4 required.\n\nworkflow-concurrency-option-allowed (enabled):\n        Allows the use of the `concurrency` option in workflows. See https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#concurrency for more information.\n        GitHub Enterprise Server >= ghes-3.2 required.\n\nEnable features by passing --enable-features feature-1 feature-2\nDisable features by passing --disable-features feature-1 feature-2\n```\n\n<!-- markdownlint-enable search-replace -->\n\nPara alternar sinalizadores de recursos, use um dos seguintes métodos:\n* Use as opções `--enable-features` e `--disable-features` ao executar um comando `gh actions-importer`.\n* Use uma variável de ambiente para cada sinalizador de recurso.\n\nUse as opções `--enable-features` e `--disable-features` para selecionar recursos específicos para habilitá-los ou desabilitá-los pelo tempo de duração do comando.\nPor exemplo, o seguinte comando desabilita o uso de `actions/cache` e `composite-actions`:\n\n```shell\ngh actions-importer dry-run ... --disable-features=composite-actions actions/cache\n```\n\nUse o comando `configure --features` para configurar de maneira interativa os sinalizadores de recursos e gravá-los automaticamente no seu ambiente:\n\n```shell\n$ gh actions-importer configure --features\n\n✔ Which features would you like to configure?: actions/cache, reusable-workflows\n✔ actions/cache (disabled): Enable\n? reusable-workflows (disabled):\n› Enable\n  Disable\n```\n\n### Como desabilitar o cache de resposta de rede\n\nPor padrão, GitHub Actions Importer armazena em cache respostas de solicitações de rede para reduzir a carga de rede e reduzir o tempo de execução. Você pode usar a opção `--no-http-cache` para desabilitar o cache de rede. Por exemplo:\n\n```shell\ngh actions-importer forecast ... --no-http-cache\n```\n\n## Argumentos de caminho\n\nAo executar GitHub Actions Importer, os argumentos de caminho são relativos ao disco do contêiner, portanto, não há suporte para caminhos absolutos relativos ao computador host do contêiner. Quando GitHub Actions Importer é executado, o diretório do `/data` contêiner é montado no diretório onde GitHub Actions Importer é executado.\n\nPor exemplo, o seguinte comando, quando usado no `/Users/mona` diretório, gera o resumo da GitHub Actions Importer auditoria para o `/Users/mona/out` diretório:\n\n```shell\ngh actions-importer audit --output-dir /data/out\n```\n\n## Como usar um proxy\n\nPara acessar servidores configurados com um proxy HTTP, você deve definir as seguintes variáveis de ambiente com a URL do proxy:\n\n* `OCTOKIT_PROXY`: para qualquer GitHub servidor.\n* `HTTP_PROXY` (ou `HTTPS_PROXY`): para qualquer outro servidor.\n\nPor exemplo:\n\n```shell\nexport OCTOKIT_PROXY=https://proxy.example.com:8443\nexport HTTPS_PROXY=$OCTOKIT_PROXY\n```\n\nSe o proxy exigir autenticação, nome de usuário e senha, estes deverão ser incluídos na URL do proxy. Por exemplo, `https://username:password@proxy.url:port`.\n\n## Como desabilitar a verificação de certificado TLS\n\nPor padrão, GitHub Actions Importer verifica os certificados SSL ao fazer solicitações de rede. Você pode desabilitar a verificação de certificado SSL com a opção `--no-ssl-verify`. Por exemplo:\n\n```shell\ngh actions-importer audit --output-dir ./output --no-ssl-verify\n```\n\n## Aviso legal\n\nPartes foram adaptadas do https://github.com/github/gh-actions-importer/ de acordo com a licença MIT:\n\n```text\nMIT License\n\nCopyright (c) 2022 GitHub\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```"}