9.6 KiB
title, shortTitle, intro, product, miniTocMaxHeadingLevel, versions, type, topics, redirect_from, ms.openlocfilehash, ms.sourcegitcommit, ms.translationtype, ms.contentlocale, ms.lasthandoff, ms.locfileid
| title | shortTitle | intro | product | miniTocMaxHeadingLevel | versions | type | topics | redirect_from | ms.openlocfilehash | ms.sourcegitcommit | ms.translationtype | ms.contentlocale | ms.lasthandoff | ms.locfileid | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Como usar o GitHub Codespaces com a CLI do GitHub | GitHub CLI | Você pode trabalhar com o {% data variables.product.prodname_github_codespaces %} diretamente de sua linha de comando usando `gh`, a interface de linha de comando {% data variables.product.product_name %}. | {% data reusables.gated-features.codespaces %} | 3 |
|
how_to |
|
|
7649692f45f0a899649baa2007d64e0a76bc32ec | fcf3546b7c |
HT | pt-BR | 09/10/2022 | 147875682 |
Sobre a {% data variables.product.prodname_cli %}
{% data reusables.cli.about-cli %} Para obter mais informações, confira "Sobre a {% data variables.product.prodname_cli %}".
Você pode trabalhar com {% data variables.product.prodname_codespaces %} em {% data variables.product.prodname_cli %} para:
- Listar todos os seus codespaces
- Criar um novo codespace
- Parar um codespace
- Excluir um codespace
- Usar o SSH em um codespace
- Abrir um codespace no {% data variables.product.prodname_vscode %}
- Abrir um codespace no JupyterLab
- Copiar um arquivo de/para um codespace
- Modificar as portas em um codespace
- Acessar os logs do codespace
- Acessar recursos remotos
Como instalar a {% data variables.product.prodname_cli %}
{% data reusables.cli.cli-installation %}
Como usar a {% data variables.product.prodname_cli %}
Se você ainda não fez isso, execute gh auth login para se autenticar com sua conta do {% data variables.product.prodname_dotcom %}.
Para usar gh para trabalhar com o {% data variables.product.prodname_codespaces %}, digite gh codespace <COMMAND> ou o alias gh cs <COMMAND>.
Como exemplo de uma série de comandos que você pode usar para trabalhar com {% data variables.product.prodname_github_codespaces %}, você pode:
- Liste seus codespaces atuais para verificar se você tem um codespace para um repositório específico:
gh codespace list - Crie um codespace para o branch do repositório necessário:
gh codespace create -r github/docs -b main - Use o SSH no novo codespace:
gh codespace ssh -c mona-github-docs-v4qxrv7rfwv9w - Encaminhe uma porta para o computador local:
gh codespace ports forward 8000:8000 -c mona-github-docs-v4qxrv7rfwv9w
Comandos gh do {% data variables.product.prodname_github_codespaces %}
As seções abaixo fornecem exemplos de comandos para cada uma das operações disponíveis.
Para ver uma referência completa de comandos gh do {% data variables.product.prodname_github_codespaces %}, incluindo detalhes de todas as opções disponíveis para cada comando, confira a ajuda online da {% data variables.product.prodname_cli %} para "gh codespace". Como alternativa, use gh codespace [<SUBCOMMAND>...] --help na linha de comando.
{% note %}
Observação: o sinalizador -c <em>codespace-name</em>, usado com muitos comandos, é opcional. Se você omitir, será exibida uma uma lista de codespaces para você escolher.
{% endnote %}
Listar todos os seus codespaces
gh codespace list
A lista inclui o nome exclusivo de cada codespace, que você pode usar em outros comandos gh codespace.
Criar um novo codespace
gh codespace create -r <em>owner/repository</em> [-b <em>branch</em>]
Para obter mais informações, confira "Como criar um codespace".
Parar um codespace
gh codespace stop -c <em>codespace-name</em>
Para ver mais informações, confira "Aprofundamento nos {% data variables.product.prodname_github_codespaces %}".
Excluir um codespace
gh codespace delete -c <em>codespace-name</em>
Para obter mais informações, confira "Como excluir um codespace".
SSH em um codespace
Para executar comandos na máquina de codespace remoto, a partir do seu terminal, você pode fazer SSH no codespace.
gh codespace ssh -c <em>codespace-name</em>
{% data variables.product.prodname_github_codespaces %} copia suas chaves SSH no codespace ao criar para uma experiência de autenticação perfeita. É possível que se solicite a senha da sua chave SSH e, após isso, você obterá uma instrução de comando da máquina de codespace remoto.
Se você não tiver nenhuma chave SSH, siga as instruções descritas em "Como gerar uma nova chave SSH e adicioná-la ao ssh-agent".
Abrir um codespace em {% data variables.product.prodname_vscode %}
gh codespace code -c <em>codespace-name</em>
Para obter mais informações, confira "Como usar o {% data variables.product.prodname_codespaces %} no {% data variables.product.prodname_vscode %}".
Abrir um codespace no JupyterLab
gh codespace jupyter -c <em>codespace-name</em>
Copiar um arquivo de/para um codespace
gh codespace cp [-r] <em>source(s)</em> <em>destination</em>
Use o prefixo remote: em um nome de arquivo ou de diretório para indicar que ele está no codespace. Assim como no comando UNIX cp, o primeiro argumento especifica a origem e o último especifica o destino. Se o destino for um diretório, você poderá especificar várias fontes. Use o sinalizador -r (recursivo) se uma das fontes for um diretório.
O local dos arquivos e diretórios no codespace é relativo ao diretório principal do usuário remoto.
Exemplos
-
Copie um arquivo do computador local para o diretório
$HOMEde um codespace:gh codespace cp myfile.txt remote: -
Copiar um arquivo para o diretório no qual se faz o check-out de um repositório em um codespace:
gh codespace cp myfile.txt remote:/workspaces/<REPOSITORY-NAME> -
Copiarum arquivo de um código para o diretório atual na máquina local:
gh codespace cp remote:myfile.txt . -
Copie três arquivos locais para o diretório
$HOME/tempde um codespace:gh codespace cp a1.txt a2.txt a3.txt remote:temp -
Copie três arquivos de um codespace para o diretório de trabalho atual na máquina local:
gh codespace cp remote:a1.txt remote:a2.txt remote:a3.txt . -
Copie um diretório local para o diretório
$HOMEde um codespace:gh codespace cp -r mydir remote: -
Copiar o diretório de um codespace para a máquina local, alterando o nome do diretório:
gh codespace cp -r remote:mydir mydir-localcopy
Para obter mais informações sobre o comando gh codespace cp, incluindo sinalizadores adicionais que você pode usar, confira o manual da {% data variables.product.prodname_cli %}.
Modificar portas em um codespace
Você pode encaminhar uma porta em um codespace para uma porta local. A porta será encaminhada enquanto o processo estiver em execução. Para interromper o encaminhamento da porta, pressione Control+C.
gh codespace ports forward <em>codespace-port-number</em>:<em>local-port-number</em> -c <em>codespace-name</em>
Para ver os detalhes das portas encaminhadas, insira gh codespace ports e escolha um codespace.
Você pode definir a visibilidade de uma porta encaminhada. {% data reusables.codespaces.port-visibility-settings %}
gh codespace ports visibility <em>codespace-port</em>:<em>private|org|public</em> -c <em>codespace-name</em>
Você pode definir a visibilidade de várias portas com um comando. Por exemplo:
gh codespace ports visibility 80:private 3000:public 3306:org -c <em>codespace-name</em>
Para obter mais informações, confira "Como encaminhar portas no seu codespace".
Acessar registros de codespaces
Você pode ver o registro de criação de um codespace. Depois de entrar neste comando será solicitado que você digite a senha da sua chave SSH.
gh codespace logs -c <em>codespace-name</em>
Para ver mais informações sobre o log de criação, confira "logs do {% data variables.product.prodname_github_codespaces %}".
Acessar recursos remotos
Você pode usar a extensão {% data variables.product.prodname_cli %} para criar uma ponte entre um codespace e seu computador local, e o codespace possa acessar qualquer recurso remoto que esteja acessível em seu computador. Para obter mais informações sobre como usar a extensão, confira "Como usar dados {% data variables.product.prodname_cli %} para acessar recursos remotos".
{% note %}
Observação: a extensão {% data variables.product.prodname_cli %} está atualmente na versão beta e sujeita a alterações.
{% endnote %}