CloudAcademia
PT

Computação em nuvem · Módulo 02 · Primeiros passos no terminal

Laboratório: os seus primeiros comandos

Laboratório40 minPrimeiros passosMarkdown

A mostrar o Markdown sem formatação: não foi possível carregar o visualizador.

## Objetivo
Abrir um terminal e usá-lo para construir uma pequena árvore de pastas e ficheiros, navegar nela, alterá-la e provocar alguns erros de propósito para os reconhecer mais tarde. Tudo acontece numa pasta de prática que é apagada no final.

## Objetivos
- Abrir um terminal e executar `pwd` e `ls`.
- Navegar entre pastas com `cd`, usando caminhos relativos e absolutos.
- Criar, ler, copiar, renomear, mover e apagar ficheiros e pastas.
- Ler três mensagens de erro comuns e obter ajuda com `--help` e `man`.

## Pré-requisitos
- Um computador com Linux ou macOS, ou com Windows e WSL (Windows Subsystem for Linux, subsistema do Windows para Linux) já instalado. O passo 1 mostra como instalá-lo.
- Não são necessários conta, dados de pagamento nem acesso à rede. Custo: gratuito.
- A [lição Primeiros passos no terminal](lesson.pt.md) deste módulo.

> [!WARNING]
> Tudo o que criar fica numa única pasta, `~/terminal-practice`, dentro da sua própria pasta pessoal. O único apagamento que se faz é dentro dessa pasta. Não execute `rm` sobre mais nada e escreva os comandos exatamente como são apresentados. Os comandos deste laboratório nunca precisam de `sudo`.

## Arquitetura
<figure class="diagram" style="--dg-w: 1040px"><svg xmlns="http://www.w3.org/2000/svg" class="dg" viewBox="0 0 1040 270" width="1040" height="270" role="img" aria-labelledby="terminal-lab-architecture-pt-title terminal-lab-architecture-pt-desc" font-family="Inter, system-ui, -apple-system, Segoe UI, Roboto, sans-serif" xml:lang="pt">
<title id="terminal-lab-architecture-pt-title">Plano do laboratório: cinco passos curtos no seu próprio terminal</title>
<desc id="terminal-lab-architecture-pt-desc">Dentro de um painel intitulado o seu terminal, na pasta ~/terminal-practice, cinco cartões numerados ligados por setas: 1 abra-o, abra um terminal e execute pwd e ls; 2 crie uma árvore, com mkdir, touch e cd para fazer pastas e ficheiros; 3 trabalhe com ficheiros, com echo, cat, cp, mv e rm; 4 leia erros, provocando três de propósito e lendo-os; 5 peça ajuda, usando --help para encontrar uma opção. Uma nota diz que nada fora de ~/terminal-practice é alterado e que a última secção a apaga.</desc>
<rect class="dg-bg" x="0.5" y="0.5" width="1039" height="269" rx="16" fill="#ffffff" stroke="#e3e3dd"/>
<g class="dg-l2"><rect class="dg-tint" x="20" y="20" width="1000" height="230" rx="16" fill="#f1f7f3" stroke="#a1ccb1" stroke-width="1.2" stroke-dasharray="6 5"/>
<g class="dg-icon" transform="translate(36 33) scale(0.7500)" fill="none" stroke="#15803d" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="4 17 10 11 4 5"/><line x1="12" x2="20" y1="19" y2="19"/></g>
<text x="62" y="47" font-size="13" class="dg-ink" fill="#15803d" font-weight="700">O seu terminal, na pasta ~/terminal-practice</text></g>
<rect class="dg-card" x="44" y="70" width="166.4" height="118" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l2"><circle class="dg-solid" cx="66" cy="94" r="12" fill="#15803d"/><text x="66" y="98.5" font-size="12.5" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">1</text></g>
<g class="dg-l2"><g class="dg-icon" transform="translate(170.4 82) scale(1.0833)" fill="none" stroke="#15803d" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><polyline points="4 17 10 11 4 5"/><line x1="12" x2="20" y1="19" y2="19"/></g></g>
<text x="58" y="132" font-size="14" class="dg-text" fill="#17171c" font-weight="700">Abra-o</text>
<text x="58" y="152" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500">Abra um terminal e</text>
<text x="58" y="169" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500">execute pwd e ls</text>
<path class="dg-line" d="M216.4 129H234.4" stroke="#cfcfc8" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<path class="dg-line" d="M226.4 123l8 6-8 6" stroke="#cfcfc8" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<rect class="dg-card" x="240.4" y="70" width="166.4" height="118" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l2"><circle class="dg-solid" cx="262.4" cy="94" r="12" fill="#15803d"/><text x="262.4" y="98.5" font-size="12.5" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">2</text></g>
<g class="dg-l2"><g class="dg-icon" transform="translate(366.8 82) scale(1.0833)" fill="none" stroke="#15803d" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z"/></g></g>
<text x="254.4" y="132" font-size="14" class="dg-text" fill="#17171c" font-weight="700">Crie uma árvore</text>
<text x="254.4" y="152" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500">mkdir, touch e cd:</text>
<text x="254.4" y="169" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500">pastas e ficheiros</text>
<path class="dg-line" d="M412.8 129H430.8" stroke="#cfcfc8" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<path class="dg-line" d="M422.8 123l8 6-8 6" stroke="#cfcfc8" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<rect class="dg-card" x="436.8" y="70" width="166.4" height="118" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l2"><circle class="dg-solid" cx="458.8" cy="94" r="12" fill="#15803d"/><text x="458.8" y="98.5" font-size="12.5" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">3</text></g>
<g class="dg-l2"><g class="dg-icon" transform="translate(563.2 82) scale(1.0833)" fill="none" stroke="#15803d" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M10 9H8"/><path d="M16 13H8"/><path d="M16 17H8"/></g></g>
<text x="450.8" y="132" font-size="14" class="dg-text" fill="#17171c" font-weight="700">Trabalhe com ficheiros</text>
<text x="450.8" y="152" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500">echo, cat, cp,</text>
<text x="450.8" y="169" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500">mv e rm</text>
<path class="dg-line" d="M609.2 129H627.2" stroke="#cfcfc8" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<path class="dg-line" d="M619.2 123l8 6-8 6" stroke="#cfcfc8" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<rect class="dg-card" x="633.2" y="70" width="166.4" height="118" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l2"><circle class="dg-solid" cx="655.2" cy="94" r="12" fill="#15803d"/><text x="655.2" y="98.5" font-size="12.5" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">4</text></g>
<g class="dg-l2"><g class="dg-icon" transform="translate(759.6 82) scale(1.0833)" fill="none" stroke="#15803d" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3"/><path d="M12 9v4"/><path d="M12 17h.01"/></g></g>
<text x="647.2" y="132" font-size="14" class="dg-text" fill="#17171c" font-weight="700">Leia erros</text>
<text x="647.2" y="152" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500">Provoque três de</text>
<text x="647.2" y="169" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500">propósito e leia-os</text>
<path class="dg-line" d="M805.6 129H823.6" stroke="#cfcfc8" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<path class="dg-line" d="M815.6 123l8 6-8 6" stroke="#cfcfc8" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<rect class="dg-card" x="829.6" y="70" width="166.4" height="118" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-l2"><circle class="dg-solid" cx="851.6" cy="94" r="12" fill="#15803d"/><text x="851.6" y="98.5" font-size="12.5" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">5</text></g>
<g class="dg-l2"><g class="dg-icon" transform="translate(956 82) scale(1.0833)" fill="none" stroke="#15803d" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M8 6h13"/><path d="M8 12h13"/><path d="M8 18h13"/><path d="M3 6h.01"/><path d="M3 12h.01"/><path d="M3 18h.01"/></g></g>
<text x="843.6" y="132" font-size="14" class="dg-text" fill="#17171c" font-weight="700">Peça ajuda</text>
<text x="843.6" y="152" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500">Use --help para</text>
<text x="843.6" y="169" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500">encontrar uma opção</text>
<text x="520" y="222" font-size="12.5" class="dg-muted" fill="#5c5c68" font-weight="600" text-anchor="middle">Nada fora de ~/terminal-practice é alterado; a última secção apaga-a</text>
</svg></figure>

*Figura 1. Cinco passos curtos, todos num só terminal e numa só pasta de prática.*

Nas saídas apresentadas abaixo, o nome de utilizador aparece como `user`. O seu será diferente, e as datas em `ls -l` serão as de hoje. O terminal apresenta a saída e as mensagens de erro em inglês (ou no idioma do sistema), pelo que os blocos de código se mantêm tal como estão.

## Passos

### Passo 1 — Abrir um terminal e olhar à volta (5 min)
Abra um terminal no seu sistema:

- **Linux.** Abra a aplicação chamada Terminal (ou Konsole, ou semelhante). Ctrl + Alt + T funciona em muitos ambientes de trabalho.
- **macOS.** Prima Cmd + Espaço, escreva `Terminal` e prima Enter.
- **Windows.** Se ainda não tiver Linux, abra o menu Iniciar, procure PowerShell, clique com o botão direito e escolha **Executar como administrador**. Escreva `wsl --install`, prima Enter e reinicie o PC quando for pedido. Depois abra o **Ubuntu** a partir do menu Iniciar e escolha um nome de utilizador e uma palavra-passe quando for pedido (não aparece nada enquanto se escreve a palavra-passe). Alguns PC de empresas ou escolas bloqueiam o WSL: se a instalação falhar, consulte o [guia da Microsoft](https://learn.microsoft.com/en-us/windows/wsl/install) ou use uma máquina Linux. Se o Ubuntu já estiver instalado, basta abri-lo.

Verá um prompt que termina em `$` (ou em `%` em macOS). Escreva estes dois comandos, premindo Enter após cada um:

```bash
pwd
ls
```

Saída esperada (os nomes que surgem após `pwd` e `ls` serão diferentes no seu computador):
```text
/home/user
Desktop  Documents  Downloads
```

- `pwd` imprimiu a pasta atual: a sua pasta pessoal. Em macOS tem o aspeto `/Users/user`.
- `ls` listou o que existe lá dentro. Um Ubuntu acabado de instalar em WSL pode não mostrar nada: uma pasta pessoal vazia não imprime nada.

**Pense.** Que aspeto tinha o prompt e que partes reconhece (nome de utilizador, nome do computador, pasta)?

<details>
<summary>Mostrar a resposta</summary>

Em Linux ou WSL tem o aspeto `user@computer:~$`: o nome de utilizador, uma `@`, o nome do computador, dois pontos, a pasta atual e um `$`. O `~` indica que se está na pasta pessoal. Em macOS com zsh o prompt é mais curto, como `user@computer ~ %`. O prompt já lá está: nunca se escreve.

</details>

### Passo 2 — Construir uma árvore de pastas e navegar nela (10 min)
Crie a pasta de prática, entre nela e verifique onde está:

```bash
mkdir ~/terminal-practice
cd ~/terminal-practice
pwd
```

Saída esperada:
```text
/home/user/terminal-practice
```

`mkdir` e `cd` não imprimiram nada: quando um comando tem êxito, normalmente fica em silêncio. Agora crie duas pastas e dois ficheiros vazios e liste-os:

```bash
mkdir notes photos
ls
touch notes/todo.txt photos/cat.jpg
ls notes photos
```

Saída esperada:
```text
notes  photos
notes:
todo.txt

photos:
cat.jpg
```

`notes/todo.txt` é um caminho relativo: "o ficheiro `todo.txt` dentro de `notes`, a partir daqui". Agora percorra as pastas com `cd`:

```bash
cd notes
pwd
cd ..
pwd
cd ~/terminal-practice/photos
pwd
cd ../notes
pwd
cd
pwd
```

Saída esperada:
```text
/home/user/terminal-practice/notes
/home/user/terminal-practice
/home/user/terminal-practice/photos
/home/user/terminal-practice/notes
/home/user
```

- `cd notes` é um movimento relativo para baixo. `cd ..` sobe um nível.
- `cd ~/terminal-practice/photos` é um movimento absoluto: funciona a partir de qualquer lado porque parte de `~`.
- `cd ../notes` sobe um nível e depois desce para `notes`.
- `cd` sozinho leva à pasta pessoal. Volte à pasta de prática antes do passo seguinte:

```bash
cd ~/terminal-practice
```

**Pense.** Está em `~/terminal-practice/photos`. Que comando leva diretamente a `notes` com um caminho relativo?

<details>
<summary>Mostrar a resposta</summary>

`cd ../notes`. O `..` sobe até `terminal-practice`, e `notes` desce para a pasta que está ao lado de `photos`. (`cd ~/terminal-practice/notes` também funciona: é a versão absoluta.)

</details>

### Passo 3 — Escrever, ler, copiar, renomear e apagar (10 min)
Coloque texto num ficheiro com `echo` e `>`, e leia-o com `cat`:

```bash
echo "Buy milk" > notes/todo.txt
cat notes/todo.txt
```

Saída esperada:
```text
Buy milk
```

Agora escreva de novo no mesmo ficheiro com um único `>` e leia-o:

```bash
echo "Call Ana" > notes/todo.txt
cat notes/todo.txt
```

Saída esperada:
```text
Call Ana
```

"Buy milk" desapareceu: `>` substitui o conteúdo do ficheiro. Use `>>` para acrescentar uma linha e depois veja o ficheiro e os seus detalhes com `ls -l`:

```bash
echo "Buy milk" >> notes/todo.txt
cat notes/todo.txt
ls -l notes
```

Saída esperada (a data e a hora serão as suas; em alguns sistemas surge um `.` ou um `@` a seguir às permissões):
```text
Call Ana
Buy milk
total 4
-rw-r--r-- 1 user user 18 Nov  7 21:48 todo.txt
```

`-l` dá uma linha por item: permissões, proprietário, tamanho em bytes (18 carateres, incluindo as quebras de linha), data e nome. Agora copie, renomeie, mova e apague:

```bash
cp notes/todo.txt notes/backup.txt
ls notes
mv notes/backup.txt notes/old.txt
mv notes/old.txt photos/
ls notes photos
rm photos/old.txt
ls photos
```

Saída esperada:
```text
backup.txt  todo.txt
notes:
todo.txt

photos:
cat.jpg  old.txt
cat.jpg
```

- `cp` fez uma cópia, `backup.txt`, ao lado do original.
- O primeiro `mv` **renomeou-a** para `old.txt` (mesma pasta, nome novo). O segundo **moveu-a** para `photos/` (pasta nova, mesmo nome).
- `rm photos/old.txt` apagou-a definitivamente. Não há reciclagem, pelo que o último `ls photos` mostra que já não existe.

**Pense.** Que comando, `cp` ou `mv`, deixa o ficheiro original no lugar?

<details>
<summary>Mostrar a resposta</summary>

`cp`. Depois de uma cópia há dois ficheiros; depois de `mv` continua a haver um, apenas com outro nome ou noutro local.

</details>

### Passo 4 — Provocar três erros de propósito (8 min)
Os erros são mais fáceis de ler quando se sabe que foram provocados. Execute cada comando e leia a mensagem:

```bash
pwdd
cat notes/shopping.txt
cd photos/summer
```

Saída esperada (bash; a zsh em macOS formula-as de modo ligeiramente diferente, por exemplo `zsh: command not found: pwdd`):
```text
bash: pwdd: command not found
cat: notes/shopping.txt: No such file or directory
bash: cd: photos/summer: No such file or directory
```

Agora o terceiro tipo, **Permission denied**. Isto tenta ler um ficheiro que apenas o administrador pode ler. É inofensivo: apenas não se consegue lê-lo.

Em Linux ou WSL:

```bash
cat /etc/shadow
```

Saída esperada:
```text
cat: /etc/shadow: Permission denied
```

Em macOS, use `cat /etc/master.passwd` em alternativa.

> [!NOTE]
> O comando de macOS e a sua mensagem não foram executados quando este laboratório foi escrito; devem terminar em `Permission denied`. Se o sistema apresentar outra coisa, a ideia é a mesma: o sistema protege o ficheiro.

**Pense.** Para cada mensagem, o que seria a primeira coisa a verificar?

<details>
<summary>Mostrar a resposta</summary>

- `command not found`: a ortografia do comando (`pwdd` deveria ser `pwd`).
- `No such file or directory` (em `cat`): o nome do ficheiro e se se está na pasta certa (`pwd`, depois `ls`). Aqui o ficheiro simplesmente não existe.
- `No such file or directory` (em `cd`): o nome da pasta. Não existe `photos/summer`.
- `Permission denied`: não há nada a corrigir. O sistema está a proteger o ficheiro, e não se deve tentar contorná-lo.

</details>

### Passo 5 — Pedir ajuda (7 min)
Vai deparar-se muitas vezes com um comando que não conhece. Pergunte-lhe. Em Linux ou WSL:

```bash
mkdir --help
```

Saída esperada (o início; continua por cerca de 25 linhas, pelo que deve percorrer para cima se necessário):
```text
Usage: mkdir [OPTION]... DIRECTORY...
Create the DIRECTORY(ies), if they do not already exist.

Mandatory arguments to long options are mandatory for short options too.
  -m, --mode=MODE
         set file mode (as in chmod), not a=rwx - umask
  -p, --parents
         no error if existing, make parent directories as needed,
         with their file modes unaffected by any -m option
```

Em macOS, a maioria dos comandos incluídos não tem `--help`; use `man mkdir` em alternativa.

**Pense.** Que opção permite a `mkdir` criar uma pasta e todas as pastas superiores em falta de uma só vez? Leia a ajuda e experimente:

<details>
<summary>Mostrar a resposta</summary>

`-p` (forma longa `--parents`). Experimente e depois veja o interior:

```bash
mkdir -p ~/terminal-practice/projects/2026/july
ls ~/terminal-practice/projects/2026
```

Saída esperada:
```text
july
```

Sem `-p`, `mkdir` falharia porque `projects` e `2026` ainda não existem.

</details>

Por fim, abra o manual completo de um comando e volte a sair:

```bash
man ls
```

Vê uma página de texto. Prima a barra de espaços para percorrer, escreva `/` seguido de uma palavra e Enter para pesquisar, e prima `q` para sair. Se vir `No manual entry` (algumas instalações mínimas de WSL não têm páginas de manual), salte este passo: `--help` é suficiente.

## Verificação
Liste tudo o que criou:

```bash
ls -R ~/terminal-practice
```

Saída esperada:
```text
/home/user/terminal-practice:
notes  photos  projects

/home/user/terminal-practice/notes:
todo.txt

/home/user/terminal-practice/photos:
cat.jpg

/home/user/terminal-practice/projects:
2026

/home/user/terminal-practice/projects/2026:
july

/home/user/terminal-practice/projects/2026/july:
```

`-R` lista as pastas e tudo o que contêm. Se a saída coincidir, fez todo o laboratório. Execute `cat ~/terminal-practice/notes/todo.txt` para ver as duas linhas do passo 3.

## Resolução de problemas
| Sintoma | Causa provável | Solução |
|---|---|---|
| `command not found` num comando deste laboratório | Uma gralha ou uma maiúscula | Escreva-o de novo; prima a seta para cima para editar o último comando |
| `No such file or directory` | Nome errado, ou está noutra pasta | Execute `pwd` e `ls`, e depois `cd ~/terminal-practice` |
| `File exists` ao executar `mkdir` | A pasta já existe (por exemplo, por ter executado o passo duas vezes) | Nada a corrigir; continue |
| O terminal parece bloqueado depois de `man ls` | A página de manual continua aberta | Prima `q` |
| Não aparece nada ao escrever uma palavra-passe | Normal: os terminais ocultam as palavras-passe | Escreva-a na mesma e prima Enter |
| `wsl --install` falha ou está bloqueado | Um PC restrito, ou uma versão antiga do Windows | Consulte a equipa de TI ou use uma máquina Linux |

## Desafio (opcional)
Sem olhar para trás, crie uma pasta `trip` em `~/terminal-practice` com uma subpasta `tickets`, escreva a linha `Flight at 9:30` em `trip/tickets/flight.txt` e leia-a com `cat`. Depois use `ls -l` para descobrir quantos bytes ocupa.

## Limpeza
Apague a pasta de prática. `-r` remove a pasta e tudo o que contém, e não há como desfazer, pelo que deve verificar que o caminho é exatamente o apresentado:

```bash
cd
rm -r ~/terminal-practice
ls
```

`ls` já não deve listar `terminal-practice`. Mais nada foi alterado no computador.

## O que aprendeu
- Um terminal executa um comando de cada vez: comando, opções e argumentos, com o prompt já presente.
- `pwd`, `ls` e `cd` mostram onde se está e permitem navegar, com caminhos absolutos (a partir de `/` ou `~`) e caminhos relativos (com `.` e `..`).
- `mkdir`, `touch`, `echo >`, `cat`, `cp`, `mv` e `rm` criam, leem, copiam, renomeiam, movem e apagam. `>` substitui, `>>` acrescenta, e `rm` não pode ser desfeito.
- Os erros são legíveis: `command not found`, `No such file or directory` e `Permission denied` indicam o que verificar.
- `--help` e `man` explicam qualquer comando, pelo que nunca é preciso decorá-los.