From efc07c3ae45fd2aaed1e3fbe42146ab5e0a77568 Mon Sep 17 00:00:00 2001 From: Carlos Ferrer <52231010+carlosferrerdev@users.noreply.github.com> Date: Wed, 20 Sep 2023 05:05:50 -0300 Subject: [PATCH] Le Wagon Setup now in Portuguese version too (#442) * Add portuguese language option * Correction on portuguese sentence * Adding portuguese (pt) partials folder with contents and adding "pt" on `build.rb` --- README.md | 4 + README.pt.md | 23 + _partials/pt/checkup.md | 19 + _partials/pt/cli_tools.md | 56 + _partials/pt/conclusion.md | 5 + _partials/pt/dotfiles.md | 76 ++ _partials/pt/gh_cli.md | 50 + _partials/pt/github.md | 7 + _partials/pt/intro.md | 11 + _partials/pt/kitt.md | 14 + _partials/pt/macos_apple_silicon.md | 46 + _partials/pt/macos_command_line_tools.md | 38 + _partials/pt/macos_homebrew.md | 67 ++ _partials/pt/macos_postgresql.md | 35 + _partials/pt/macos_rbenv.md | 33 + _partials/pt/macos_settings.md | 47 + _partials/pt/macos_slack.md | 9 + _partials/pt/macos_sqlite.md | 19 + _partials/pt/macos_terminal.md | 9 + _partials/pt/macos_vscode.md | 21 + _partials/pt/macos_zoom.md | 33 + _partials/pt/nvm.md | 41 + _partials/pt/oh_my_zsh.md | 19 + _partials/pt/rbenv.md | 30 + _partials/pt/ruby.md | 81 ++ _partials/pt/slack_settings.md | 25 + _partials/pt/sqlite.md | 19 + _partials/pt/ssh_agent.md | 15 + _partials/pt/ubuntu_postgresql.md | 15 + _partials/pt/ubuntu_settings.md | 51 + _partials/pt/ubuntu_slack.md | 9 + _partials/pt/ubuntu_vscode.md | 47 + _partials/pt/vscode_extensions.md | 29 + _partials/pt/vscode_liveshare.md | 16 + _partials/pt/windows_browser.md | 114 ++ _partials/pt/windows_postgresql.md | 39 + _partials/pt/windows_settings.md | 52 + _partials/pt/windows_slack.md | 9 + _partials/pt/windows_terminal.md | 80 ++ _partials/pt/windows_ubuntu.md | 115 ++ _partials/pt/windows_version.md | 72 ++ _partials/pt/windows_virtualization.md | 37 + _partials/pt/windows_vscode.md | 38 + _partials/pt/windows_wsl.md | 116 ++ _partials/pt/yarn.md | 23 + _partials/pt/zoom.md | 29 + build.rb | 2 +- macos.pt.md | 755 +++++++++++++ ubuntu.pt.md | 662 ++++++++++++ windows.pt.md | 1247 ++++++++++++++++++++++ 50 files changed, 4408 insertions(+), 1 deletion(-) create mode 100644 README.pt.md create mode 100644 _partials/pt/checkup.md create mode 100644 _partials/pt/cli_tools.md create mode 100644 _partials/pt/conclusion.md create mode 100644 _partials/pt/dotfiles.md create mode 100644 _partials/pt/gh_cli.md create mode 100644 _partials/pt/github.md create mode 100644 _partials/pt/intro.md create mode 100644 _partials/pt/kitt.md create mode 100644 _partials/pt/macos_apple_silicon.md create mode 100644 _partials/pt/macos_command_line_tools.md create mode 100644 _partials/pt/macos_homebrew.md create mode 100644 _partials/pt/macos_postgresql.md create mode 100644 _partials/pt/macos_rbenv.md create mode 100644 _partials/pt/macos_settings.md create mode 100644 _partials/pt/macos_slack.md create mode 100644 _partials/pt/macos_sqlite.md create mode 100644 _partials/pt/macos_terminal.md create mode 100644 _partials/pt/macos_vscode.md create mode 100644 _partials/pt/macos_zoom.md create mode 100644 _partials/pt/nvm.md create mode 100644 _partials/pt/oh_my_zsh.md create mode 100644 _partials/pt/rbenv.md create mode 100644 _partials/pt/ruby.md create mode 100644 _partials/pt/slack_settings.md create mode 100644 _partials/pt/sqlite.md create mode 100644 _partials/pt/ssh_agent.md create mode 100644 _partials/pt/ubuntu_postgresql.md create mode 100644 _partials/pt/ubuntu_settings.md create mode 100644 _partials/pt/ubuntu_slack.md create mode 100644 _partials/pt/ubuntu_vscode.md create mode 100644 _partials/pt/vscode_extensions.md create mode 100644 _partials/pt/vscode_liveshare.md create mode 100644 _partials/pt/windows_browser.md create mode 100644 _partials/pt/windows_postgresql.md create mode 100644 _partials/pt/windows_settings.md create mode 100644 _partials/pt/windows_slack.md create mode 100644 _partials/pt/windows_terminal.md create mode 100644 _partials/pt/windows_ubuntu.md create mode 100644 _partials/pt/windows_version.md create mode 100644 _partials/pt/windows_virtualization.md create mode 100644 _partials/pt/windows_vscode.md create mode 100644 _partials/pt/windows_wsl.md create mode 100644 _partials/pt/yarn.md create mode 100644 _partials/pt/zoom.md create mode 100644 macos.pt.md create mode 100644 ubuntu.pt.md create mode 100644 windows.pt.md diff --git a/README.md b/README.md index c8f26085..9c79560e 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,10 @@ Haga clic en este enlace para acceder a la versión en español de la configuración. +## Em Português? + +Clique neste link para acessar a versão em português da configuração. + ## En Français ? Clique sur ce lien pour accéder à la version française du setup. diff --git a/README.pt.md b/README.pt.md new file mode 100644 index 00000000..2ca38b32 --- /dev/null +++ b/README.pt.md @@ -0,0 +1,23 @@ +## Em Português? + +Guias de configuração para o curso de desenvolvimento web [Wagon](https://www.lewagon.com). Escolha seu sistema operacional (SO): + + + + + + + +
+ + macOS + + + + Windows + + + + Ubuntu + +
diff --git a/_partials/pt/checkup.md b/_partials/pt/checkup.md new file mode 100644 index 00000000..320157fb --- /dev/null +++ b/_partials/pt/checkup.md @@ -0,0 +1,19 @@ +## Checagem + +Vamos verificar se você instalou tudo com sucesso. + +No seu terminal, execute o seguinte comando: + +```bash +exec zsh +``` + +Então corra: + +```bash +curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb +``` + +:heavy_check_mark: Se você receber uma mensagem verde `Awesome! Your computer is now ready!`, então você está bem: +1: + +:x: Caso contrário, **entre em contato com um professor**. diff --git a/_partials/pt/cli_tools.md b/_partials/pt/cli_tools.md new file mode 100644 index 00000000..91020ee9 --- /dev/null +++ b/_partials/pt/cli_tools.md @@ -0,0 +1,56 @@ +## Ferramentas de linha de comando + +###Zsh e Git + +Em vez de usar o `bash` [shell] padrão (https://en.wikipedia.org/wiki/Shell_(computing)), usaremos `zsh`. + +Também usaremos [`git`](https://git-scm.com/), um software de linha de comando usado para controle de versão. + +Vamos instalá-los, juntamente com outras ferramentas úteis: +- Abra um **terminal Ubuntu** +- Copie e cole os seguintes comandos: + +```bash +sudo apt update +``` + +```bash +sudo apt install -y curl git imagemagick jq unzip vim zsh tree +``` + +Esses comandos solicitarão sua senha: digite-a. + +:aviso: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +### Instalação da CLI do GitHub + +Vamos agora instalar a [CLI oficial do GitHub](https://cli.github.com) (interface de linha de comando). É um software usado para interagir com sua conta GitHub através da linha de comando. + +Em seu terminal, copie e cole os seguintes comandos e digite sua senha, se solicitado: + +```bash +sudo apt remove -y gitsome # gh command can conflict with gitsome if already installed +curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg +``` + +```bash +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null +``` + +```bash +sudo apt update +``` + +```bash +sudo apt install -y gh +``` + +Para verificar se `gh` foi instalado com sucesso em sua máquina, você pode executar: + +```bash +gh --version +``` + +:heavy_check_mark: Se você vir `gh versão X.Y.Z (AAAA-MM-DD)`, está pronto para prosseguir :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** diff --git a/_partials/pt/conclusion.md b/_partials/pt/conclusion.md new file mode 100644 index 00000000..0d29a34e --- /dev/null +++ b/_partials/pt/conclusion.md @@ -0,0 +1,5 @@ +## Configuração concluída! + +Seu computador agora está pronto para o [curso de Desenvolvimento Web Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: + +Aproveite o bootcamp, você vai acertar :rocket: diff --git a/_partials/pt/dotfiles.md b/_partials/pt/dotfiles.md new file mode 100644 index 00000000..9300699d --- /dev/null +++ b/_partials/pt/dotfiles.md @@ -0,0 +1,76 @@ +## Dotfiles (configuração padrão) + +Os hackers adoram refinar e aprimorar sua estrutura e ferramentas. + +Começaremos com uma ótima configuração padrão fornecida pelo Le Wagon: [`lewagon/dotfiles`](https://github.com/lewagon/dotfiles). + +Como sua configuração é pessoal, você precisa de seu próprio repositório para armazená-la. Então você irá fazer o **fork** do repositório Le Wagon. + +Bifurcar significa que você criará um novo repositório em sua própria conta GitHub `$GITHUB_USERNAME/dotfiles`, idêntico ao original do Le Wagon que você poderá modificar à vontade. + +Abra seu terminal e defina uma variável para seu nome de usuário GitHub: + +```bash +export GITHUB_USERNAME=`gh api user | jq -r '.login'` +``` + +```bash +echo $GITHUB_USERNAME +``` + +:heavy_check_mark: Você deverá ver seu nome de usuário do GitHub impresso. + +:x: Se não, **pare aqui** e peça ajuda. Pode haver um problema com a etapa anterior (`gh auth`). + +:warning: Por favor note que esta variável só é definida para o tempo em que seu terminal está aberto. Se você fechá-lo antes ou durante as próximas etapas, será necessário configurá-lo novamente com as duas etapas acima! + + +É hora de fazer um fork do repositório e cloná-lo em seu computador: + +```bash +mkdir -p ~/code/$GITHUB_USERNAME && cd $_ +``` + +```bash +gh repo fork lewagon/dotfiles --clone +``` + +### Instalador do Dotfiles + +Execute o instalador `dotfiles`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles +``` + +```bash +zsh install.sh +``` + +Verifique os e-mails registrados em sua conta GitHub. Você precisará escolher um na próxima etapa: + +```bash +gh api user/emails | jq -r '.[].email' +``` + +:heavy_check_mark: Se você vir a lista de seus e-mails registrados, você pode prosseguir :+1: + +:x: Caso contrário, [reautentique no GitHub](https://github.com/lewagon/setup/blob/master/#github-cli) antes de executar este comando :point_up: novamente. + +### instalador git + +Execute o instalador `git`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh +``` + +:point_up: Isso **solicitará** seu nome (`Nome Sobrenome`) e seu e-mail. + +:warning: Você **precisa** colocar um dos e-mails listados acima graças ao comando anterior `gh api ...`. Se você não fizer isso, Kitt não conseguirá acompanhar seu progresso. + +Agora **reinicie** seu terminal executando: + +```bash +exec zsh +``` diff --git a/_partials/pt/gh_cli.md b/_partials/pt/gh_cli.md new file mode 100644 index 00000000..aac4a6a9 --- /dev/null +++ b/_partials/pt/gh_cli.md @@ -0,0 +1,50 @@ +## CLI do GitHub + +CLI é o acrônimo de [Interface de linha de comando](https://en.wikipedia.org/wiki/Command-line_interface). + +Nesta seção, usaremos [GitHub CLI](https://cli.github.com/) para interagir com o GitHub diretamente do terminal. + +Ele já deve estar instalado no seu computador a partir dos comandos anteriores. + +Primeiro, para **fazer login**, copie e cole o seguinte comando em seu terminal: + +:aviso: **NÃO edite o `email`** + +```bash +gh auth login -s 'user:email' -w +``` + +gh fará algumas perguntas: + +`What is your preferred protocol for Git operations?` Com as setas, escolha `SSH` e pressione `Enter`. SSH é um protocolo para fazer login usando chaves SSH em vez do conhecido par nome de usuário/senha. + +`Generate a new SSH key to add to your GitHub account?` Pressione `Enter` para pedir ao gh para gerar as chaves SSH para você. + +Se você já possui chaves SSH, verá `Upload your SSH public key to your GitHub account?` Com as setas, selecione o caminho do arquivo de sua chave pública e pressione `Enter`. + +`Enter a passphrase for your new SSH key (Optional)`. Digite algo que você deseja e que você lembrará. É uma senha para proteger sua chave privada armazenada no disco rígido. Em seguida, pressione `Enter`. + +`Title for your SSH key`. Você pode deixá-lo no "GitHub CLI" proposto, pressione `Enter`. + +Você obterá então a seguinte saída: + +```bash +! First copy your one-time code: 0EF9-D015 +- Press Enter to open github.com in your browser... +``` + +Selecione e copie o código (`0EF9-D015` no exemplo) e pressione `Enter`. + +Seu navegador será aberto e solicitará que você autorize o GitHub CLI a usar sua conta GitHub. Aceite e espere um pouco. + +Volte ao terminal, pressione `Enter` novamente e pronto. + +Para verificar se você está conectado corretamente, digite: + +```bash +gh auth status +``` + +:heavy_check_mark: Se você estiver `Logado no github.com como `, então tudo bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. diff --git a/_partials/pt/github.md b/_partials/pt/github.md new file mode 100644 index 00000000..cb73cb03 --- /dev/null +++ b/_partials/pt/github.md @@ -0,0 +1,7 @@ +## Conta GitHub + +Você se inscreveu no GitHub? Caso contrário, [faça isso imediatamente](https://github.com/join). + +:point_right: **[Carregue uma imagem](https://github.com/settings/profile)** e coloque seu nome corretamente em sua conta GitHub. Isso é importante porque usaremos um painel interno com seu avatar. Faça isso **agora**, antes de continuar com este guia. + +![Imagem do GitHub](images/github_picture.png) diff --git a/_partials/pt/intro.md b/_partials/pt/intro.md new file mode 100644 index 00000000..57a5fc1d --- /dev/null +++ b/_partials/pt/intro.md @@ -0,0 +1,11 @@ +# Instruções de configuração + +Você encontrará abaixo as instruções para configurar seu computador para o [curso de desenvolvimento web Le Wagon](https://www.lewagon.com/web-development-course/full-time). + +Por favor **leia-os com atenção e execute todos os comandos na seguinte ordem**. + +Se você tiver dúvidas, não hesite em pedir ajuda a um professor :raising_hand: + +Você também pode dar uma olhada em [nossas cheatsheets](https://github.com/lewagon/setup/tree/master/docs) para soluções e dicas de problemas comuns :heavy_check_mark: + +Vamos começar :rocket: diff --git a/_partials/pt/kitt.md b/_partials/pt/kitt.md new file mode 100644 index 00000000..c42b8ff4 --- /dev/null +++ b/_partials/pt/kitt.md @@ -0,0 +1,14 @@ +## Kitt + +:warning: Se você recebeu um e-mail do Le Wagon convidando você a se inscrever no Kitt (nossa plataforma de aprendizagem), você pode pular esta etapa com segurança. Em vez disso, siga as instruções no e-mail que você recebeu, caso ainda não tenha feito isso. + +Se não tiver certeza sobre o que fazer, siga [este link](https://kitt.lewagon.com/). Se você já estiver logado, pode pular esta seção com segurança. Se você não estiver logado, clique em `Enter Kitt as a Student`. Se você conseguir fazer login, poderá pular esta etapa com segurança. Caso contrário, pergunte a um professor se você deveria ter recebido um e-mail ou siga as instruções abaixo. + +Registre-se como Alumni da Le Wagon acessando [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Selecione seu batch, faça login no GitHub e insira todas as suas informações. + +Seu professor irá então validar que você realmente faz parte do batch. Você pode pedir que eles façam isso assim que preencher o formulário de registro. + +Assim que o professor aprovar seu perfil, acesse sua caixa de entrada de e-mail. Você deve ter 2 e-mails: + +- Um do Slack, convidando você para a comunidade Le Wagon Alumni do Slack (onde você conversará com seus amigos e todos os ex-alunos anteriores). Clique em **Inscreva-se** e preencha os dados. +- Um do GitHub, convidando você para a equipe `lewagon`. **Aceite** caso contrário você não conseguirá acessar os slides da aula. diff --git a/_partials/pt/macos_apple_silicon.md b/_partials/pt/macos_apple_silicon.md new file mode 100644 index 00000000..df825837 --- /dev/null +++ b/_partials/pt/macos_apple_silicon.md @@ -0,0 +1,46 @@ +## Chips Apple Silicon + +Se você comprou seu computador depois do final de 2020, é provável que ele tenha um novo chip de silício da Apple em vez de um processador Intel: vamos descobrir. + +Abra uma nova janela de terminal em Aplicativos > Utilitários ou pesquise-a com [Spotlight](https://support.apple.com/en-gb/HT204014): + +![Abra Terminal no macOS](images/macos_open_terminal.png) + +Copie e cole o seguinte comando no terminal e pressione `Enter` para executar. + +``` bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/setup/master/utils/macos_list_processor_type.sh)" +``` + +☝️ O resultado do comando deve indicar se o seu computador usa Apple Silicon. + +Se o seu computador usa Apple Silicon, expanda o parágrafo abaixo e leia-o. Caso contrário, ignore-o. + +
+ 👉Configuração para Apple Silicon 👈 + +### Desinstalar o Homebrew + +Precisamos desinstalar o Homebrew caso uma versão nativa tenha sido instalada. + +Execute o seguinte comando no terminal: + +``` bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)" +``` + +Se o brew não estiver instalado, você receberá a mensagem `brew: comando não encontrado!` + +### Configurar Terminal para Rosetta + +Abra o aplicativo Finder (ou pesquise-o com o [Spotlight](https://support.apple.com/en-gb/HT204014)). + +Vá para Aplicativos > Utilitários. + +Duplique o aplicativo de terminal (selecione-o e, em seguida, `Cmd` + `C`, `Cmd` + `V`) e renomeie uma cópia como Terminal Rosetta. + +Pressione `Cmd` + `I` no aplicativo Terminal Rosetta e marque a caixa "Abrir usando Rosetta". + +⚠️ A partir de agora durante o bootcamp, sempre que for solicitado a abrir um Terminal, você usará o aplicativo **Terminal Rosetta**. + +
diff --git a/_partials/pt/macos_command_line_tools.md b/_partials/pt/macos_command_line_tools.md new file mode 100644 index 00000000..8a5fbf45 --- /dev/null +++ b/_partials/pt/macos_command_line_tools.md @@ -0,0 +1,38 @@ +## Uma observação sobre como encerrar aplicativos em um Mac + +Clicar na pequena cruz vermelha no canto superior esquerdo da janela do aplicativo em um Mac **não o encerra**, apenas fecha uma janela ativa. Para sair do aplicativo _de verdade_ pressione `Cmd + Q` quando o aplicativo estiver ativo ou navegue até `APP_NAME` -> `Quit` na barra de menu. + +![Sair do Terminal no macOS](images/macos_quit.png) + +Durante esta configuração, você será solicitado a **sair e reabrir** os aplicativos várias vezes. Certifique-se de fazer isso corretamente :pray: + +## Ferramentas de linha de comando + +Abra um novo terminal, copie e cole o seguinte comando e pressione `Enter`: + +```bash +xcode-select --install +``` + +Se você receber a mensagem a seguir, basta pular esta etapa e ir para a próxima. + +```bash +# ferramentas de linha de comando já estão instaladas, use "Atualização de Software" para instalar atualizações +``` + +Caso contrário, abrirá uma janela perguntando se deseja instalar algum software: clique em “Instalar” e aguarde. + + +![Instale o xcode-select no macOS](images/macos_xcode_select_install.png) + +:heavy_check_mark: Se você vir a mensagem "O software foi instalado", tudo bem :+1: + +:x: Se o comando `xcode-select --install` falhar, tente novamente: às vezes os servidores Apple ficam sobrecarregados. + +:x: Se você vir a mensagem "O Xcode não está disponível no servidor de atualização de software", será necessário atualizar o catálogo de atualização de software: + +```bash +sudo softwareupdate --clear-catalog +``` + +Feito isso, você pode tentar instalar novamente. diff --git a/_partials/pt/macos_homebrew.md b/_partials/pt/macos_homebrew.md new file mode 100644 index 00000000..b59dd14c --- /dev/null +++ b/_partials/pt/macos_homebrew.md @@ -0,0 +1,67 @@ +## Homebrew + +[Homebrew](http://brew.sh/) é um gerenciador de pacotes: é um software usado para instalar outros softwares a partir da linha de comando. Vamos instalá-lo! + +Abra um terminal e execute: + +```bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" +``` + +Isso solicitará sua confirmação (pressione `Enter`) e sua **senha da conta de usuário do macOS** (aquela que você usa para [fazer login](https://support.apple.com/en-gb/HT202860) quando você reinicia seu Macbook). + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +:warning: Se você vir este aviso :point_down:, execute os dois comandos na seção `Próximas etapas` para adicionar o Homebrew ao seu PATH: + +![Aviso de instalação do macOS Homebrew](images/macos_homebrew_warning.png) + +```bash +# ⚠️ Execute esses comandos apenas se você viu este aviso ☝ +echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile +eval "$(/opt/homebrew/bin/brew shellenv)" +``` + +Se você já tem o Homebrew, ele lhe dirá, tudo bem, vá em frente. + +Em seguida, instale algum software útil: + +```bash +brew update +``` + +Se você receber um erro `/usr/local deve ser gravável`, basta executar isto: + +```bash +sudo chown -R $USER:admin /usr/local +``` + +```bash +brew update +``` + +Continue executando o seguinte no terminal (você pode copiar/colar todas as linhas de uma vez). + +```bash +brew upgrade git || brew install git +``` + +```bash +brew upgrade gh || brew install gh +``` + +```bash +brew upgrade wget || brew install wget +``` + +```bash +brew upgrade imagemagick || brew install imagemagick +``` + +```bash +brew upgrade jq || brew install jq +``` + +```bash +brew upgrade openssl || brew install openssl +``` diff --git a/_partials/pt/macos_postgresql.md b/_partials/pt/macos_postgresql.md new file mode 100644 index 00000000..bf4d89b0 --- /dev/null +++ b/_partials/pt/macos_postgresql.md @@ -0,0 +1,35 @@ +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +brew install postgresql@15 libpq +brew link --force libpq +``` + +```bash +brew services start postgresql@15 +``` + +Depois de fazer isso, vamos verificar se funcionou: + +```bash +psql -d postgres +``` + +Você deverá ver um novo prompt como este: point_down: + +```bash +psql (15.2) +Type "help" for help. + +postgres=# +``` + +:heavy_check_mark: Se for esse o caso, digite `\q` e depois `Enter` para sair deste prompt. Você está pronto para ir: +1: + +:x: Se não, por favor ** peça um professor ** diff --git a/_partials/pt/macos_rbenv.md b/_partials/pt/macos_rbenv.md new file mode 100644 index 00000000..6d65b36f --- /dev/null +++ b/_partials/pt/macos_rbenv.md @@ -0,0 +1,33 @@ +## rbenv + +Vamos instalar o [`rbenv`](https://github.com/sstephenson/rbenv), um software para instalar e gerenciar ambientes `ruby`. + +Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter: + +```bash +rvm implode && sudo rm -rf ~/.rvm +# If you got "zsh: command not found: rvm", carry on. It means `rvm` is not +# on your computer, that's what we want! + +sudo rm -rf $HOME/.rbenv /usr/local/rbenv /opt/rbenv /usr/local/opt/rbenv +``` + +:warning: Este comando pode solicitar sua senha. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +No terminal, execute: + +```bash +brew uninstall --force rbenv ruby-build +``` + +```bash +exec zsh +``` + +Então rode: + +```bash +brew install rbenv +``` diff --git a/_partials/pt/macos_settings.md b/_partials/pt/macos_settings.md new file mode 100644 index 00000000..c3823726 --- /dev/null +++ b/_partials/pt/macos_settings.md @@ -0,0 +1,47 @@ +## Configurações do MacOS + +### Segurança + +É obrigatório que você proteja sua sessão com uma senha. Se ainda não for o caso, vá para ` > Preferências do Sistema > Usuários e Grupos` e altere a senha da sua conta. Você também deve ir para ` > Preferências do Sistema > Segurança > Geral`. Você deve exigir uma senha `5 segundos` após o início da suspensão ou da proteção de tela. + +Você também pode ir para ` > Preferências do Sistema > Controle da Missão` e clicar no botão `Hot Corners` no canto inferior esquerdo. Escolha no canto inferior direito para iniciar o protetor de tela. Dessa forma, ao sair da mesa, você pode bloquear rapidamente a tela colocando o mouse no canto inferior direito. 5 segundos depois, seu Macbook estará bloqueado e solicitará uma senha para voltar à sessão. + +### Teclado + +Ao se tornar um programador, você entenderá que deixar o teclado leva muito tempo, então você vai querer minimizar o uso do trackpad ou do mouse. Aqui estão alguns truques no macOS para ajudá-lo a fazer isso. + +#### Velocidade do teclado + +Vá para ` > Preferências do Sistema > Teclado`. Defina `Key Repeat` para a posição mais rápida (à direita) e `Delay Until Repeat` para a posição mais curta (à direita). + +#### macOS Para hackers + +[Leia este script](https://github.com/mathiasbynens/dotfiles/blob/master/.macos) e escolha algumas coisas que você acha que combinam com você. Por exemplo, você pode digitar no terminal este: + +```bash +# Expanding the save panel by default +defaults write NSGlobalDomain NSNavPanelExpandedStateForSaveMode -bool true +defaults write NSGlobalDomain PMPrintingExpandedStateForPrint -bool true +defaults write NSGlobalDomain PMPrintingExpandedStateForPrint2 -bool true + +# Save screenshots to the Desktop (or elsewhere) +defaults write com.apple.screencapture location "${HOME}/Desktop" + +# etc.. +``` + +### Fixe aplicativos no seu dock + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Vamos fixá-los no seu dock para que fiquem a apenas um clique de distância! + +Para fixar um aplicativo no seu dock, inicie o aplicativo, clique com o botão direito no ícone na barra de tarefas para abrir o menu de contexto e escolha "Opções" e depois "Manter no Dock". + +![Como fixar um aplicativo na barra de tarefas do macOS](images/macos_dock.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack +- Zoom diff --git a/_partials/pt/macos_slack.md b/_partials/pt/macos_slack.md new file mode 100644 index 00000000..471ea674 --- /dev/null +++ b/_partials/pt/macos_slack.md @@ -0,0 +1,9 @@ +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://itunes.apple.com/us/app/slack/id803453959?mt=12) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. diff --git a/_partials/pt/macos_sqlite.md b/_partials/pt/macos_sqlite.md new file mode 100644 index 00000000..6322e913 --- /dev/null +++ b/_partials/pt/macos_sqlite.md @@ -0,0 +1,19 @@ +## SQLite + +Em algumas semanas falaremos sobre bancos de dados e SQL. [SQLite](https://sqlite.org/index.html) é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +brew install sqlite +``` + +Em seguida, execute o seguinte comando: + +```bash +sqlite3 -version +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** diff --git a/_partials/pt/macos_terminal.md b/_partials/pt/macos_terminal.md new file mode 100644 index 00000000..f8de03ce --- /dev/null +++ b/_partials/pt/macos_terminal.md @@ -0,0 +1,9 @@ +## Tema do Terminal macOS + +Inicie um terminal, clique em `Terminal > Preferências` e defina o tema "Pro" como perfil padrão. + +![Definir tema Pro para terminal macOS](images/macos_terminal_pro.png) + +Na guia Janela, defina também seu **Tamanho da janela** para Colunas: 200, Linhas: 50 + +**Saia e reinicie** seu terminal: agora ele deve ter um belo fundo preto, mais agradável aos olhos. diff --git a/_partials/pt/macos_vscode.md b/_partials/pt/macos_vscode.md new file mode 100644 index 00000000..8bb9e2ae --- /dev/null +++ b/_partials/pt/macos_vscode.md @@ -0,0 +1,21 @@ +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +Copie (`Cmd` + `C`) o comando abaixo e cole-o em seu terminal (`Cmd` + `V`): + +```bash +brew install --cask visual-studio-code +``` + +Em seguida, inicie o VS Code executando o seguinte comando em seu terminal: + +```bash +code +``` + +:heavy_check_mark: Se uma janela do VS Code acabou de abrir, você está pronto: +1: + +:x: Caso contrário, por favor **entre em contato com um professor** diff --git a/_partials/pt/macos_zoom.md b/_partials/pt/macos_zoom.md new file mode 100644 index 00000000..3dc4644a --- /dev/null +++ b/_partials/pt/macos_zoom.md @@ -0,0 +1,33 @@ +## Zoom + +Para poder interagir quando não estivermos na mesma sala física, usaremos o [Zoom](https://zoom.us/), uma ferramenta de videoconferência. + +:warning: Se você já possui o Zoom instalado, certifique-se de que a versão seja pelo menos **5.6**. + +Acesse [zoom.us/download](https://zoom.us/download). + +Em **Cliente Zoom** clique no botão **Baixar**. + +Abra o arquivo que você acabou de baixar para instalar o aplicativo. + +Abra o aplicativo Zoom. + +Se você tiver um Mac com Apple Silicon, [você será solicitado a instalar o Rosetta](https://support.apple.com/en-us/HT211861). Clique em Instalar e digite seu nome de usuário e senha para permitir que a instalação continue. + +![Instale o Rosetta](https://support.apple.com/library/content/dam/edam/applecare/images/en_US/macos/Big-Sur/macos-big-sur-software-update-rosetta-alert. jpg) + +Se você já possui uma conta Zoom, faça login usando suas credenciais. + +Caso contrário, clique no link **Cadastre-se gratuitamente**: + +![Cadastre-se gratuitamente para ampliar](images/zoom_sign_up_free.png) + +Você será redirecionado ao site do Zoom para preencher um formulário. + +Quando terminar, volte para o aplicativo Zoom e faça login usando suas credenciais. + +Você deverá então ver uma tela como esta: + +![Zoom tela inicial](images/zoom_home_screen.png) + +Agora você pode fechar o aplicativo Zoom. diff --git a/_partials/pt/nvm.md b/_partials/pt/nvm.md new file mode 100644 index 00000000..0e3fb5e8 --- /dev/null +++ b/_partials/pt/nvm.md @@ -0,0 +1,41 @@ +## Node.js + +[Node.js](https://nodejs.org/en/) é um tempo de execução JavaScript para executar código JavaScript no terminal. Vamos instalá-lo com [nvm](https://github.com/nvm-sh/nvm), um gerenciador de versões para Node.js. + +Em um terminal, execute os seguintes comandos: + +```bash +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v/install.sh | zsh +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +nvm -v +``` + +Você deverá ver uma versão. Se não, pergunte a um professor. + +Agora vamos instalar o nó: + +```bash +nvm install +``` + +Quando a instalação terminar, execute: + +```bash +node -v +``` + +Se você vir `v`, a instalação foi bem-sucedida :heavy_check_mark: Você pode então executar: + +```bash +nvm cache clear +``` + +:x: Caso contrário, **entre em contato com um professor** diff --git a/_partials/pt/oh_my_zsh.md b/_partials/pt/oh_my_zsh.md new file mode 100644 index 00000000..69c6d02e --- /dev/null +++ b/_partials/pt/oh_my_zsh.md @@ -0,0 +1,19 @@ +## Oh-My-Zsh + +Vamos instalar o plugin `zsh` [Oh My Zsh](https://ohmyz.sh/). + +Em um terminal execute o seguinte comando: + +```bash +sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" +``` + +Se for perguntado "Deseja alterar seu shell padrão para zsh?", pressione `Y` + +No final seu terminal deverá ficar assim: + +![Terminal Ubuntu com OhMyZsh](images/oh_my_zsh.png) + +:heavy_check_mark: Se isso acontecer, você pode continuar :+1: + +:x: Caso contrário, por favor ** peça um professor ** diff --git a/_partials/pt/rbenv.md b/_partials/pt/rbenv.md new file mode 100644 index 00000000..e0c23d06 --- /dev/null +++ b/_partials/pt/rbenv.md @@ -0,0 +1,30 @@ +## rbenv + +Vamos instalar o [`rbenv`](https://github.com/sstephenson/rbenv), um software para instalar e gerenciar ambientes `ruby`. + +Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter: + +```bash +rvm implode && sudo rm -rf ~/.rvm +# Se você obteve "zsh: comando não encontrado: rvm", continue. +# Significa que `rvm` não está no seu computador, é isso que queremos! +rm -rf ~/.rbenv +``` + +Então no terminal, execute: + +```bash +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +``` + +```bash +git clone https://github.com/rbenv/rbenv.git ~/.rbenv +``` + +```bash +git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build +``` + +```bash +exec zsh +``` diff --git a/_partials/pt/ruby.md b/_partials/pt/ruby.md new file mode 100644 index 00000000..f5da83fd --- /dev/null +++ b/_partials/pt/ruby.md @@ -0,0 +1,81 @@ +## Ruby + +### Instalação + +Agora, você está pronto para instalar a versão mais recente do [ruby](https://www.ruby-lang.org/en/) e defini-la como a versão padrão. + +Execute este comando, **demorará um pouco (5 a 10 minutos)** + +```bash +rbenv install +``` + +Assim que a instalação do Ruby estiver concluída, execute este comando para informar ao sistema +para usar a versão por padrão. + +```bash +rbenv global +``` + +**Reinicialize** seu terminal e verifique sua versão do Ruby: + +```bash +exec zsh +``` + +Então corra: + +```bash +ruby -v +``` + +:heavy_check_mark: Se você vir algo começando com `ruby p` então você pode prosseguir :+1: + +:x: Se não, **pergunte a um professor** + +### Instalando algumas gems + +
+ Se você estiver na China 🇨🇳 clique aqui + + :warning: Se você estiver na China, você deve atualizar a forma como instalaremos o gem com os seguintes comandos. + +```bash +# Somente China! +fontes de gemas --remove https://rubygems.org/ +fontes de gemas -a https://gems.ruby-china.com/ +fontes de gemas -l +#***FONTES ATUAIS*** +# https://gems.ruby-china.com/ +# Ruby-china.com deve estar na lista agora +``` +
+ +**Todos, na China ou não**, continuem aqui para instalar gems. + +No mundo Ruby, chamamos bibliotecas externas de `gems`: são pedaços de código Ruby que você pode baixar e executar em seu computador. Vamos instalar alguns! + +No seu terminal, copie e cole o seguinte comando: + +```bash +gem install +``` + +:heavy_check_mark: Se você tiver `xx gems installed`, então tudo bem :+1: + +:x: Se você encontrar o seguinte erro: + +```bash +ERROR: While executing gem ... (TypeError) +incompatible marshal file format (can't be read) +format version 4.8 required; 60.33 given +``` + +Execute o seguinte comando: +```bash +rm -rf ~/.gemrc +``` + +Execute novamente o comando para instalar as gemas. + +:warning: **NUNCA** instale uma gem com `sudo gem install`! Mesmo se você encontrar uma resposta do Stackoverflow (ou o terminal) solicitando que você faça isso. diff --git a/_partials/pt/slack_settings.md b/_partials/pt/slack_settings.md new file mode 100644 index 00000000..6d2019be --- /dev/null +++ b/_partials/pt/slack_settings.md @@ -0,0 +1,25 @@ +### Configurações + +Inicie o aplicativo e faça login na organização `lewagon-alumni`. + +Certifique-se de **fazer upload de uma foto de perfil** :point_down: + +![Como fazer upload de uma foto de perfil no Slack](images/slack_profile_picture.gif) + +A ideia é que você tenha o Slack aberto o dia todo, para que você possa compartilhar links úteis/pedir ajuda/decidir onde ir almoçar/etc. + +Para garantir que tudo está funcionando bem nas videochamadas, vamos testar sua câmera e microfone: +- Abra o aplicativo Slack +- Clique na foto do seu perfil no canto superior direito. +- Selecione `Preferências` no menu. +- Clique em `Áudio e vídeo` na coluna do lado esquerdo. +- Abaixo de `Solução de problemas`, clique em `Executar um teste de áudio, vídeo e compartilhamento de tela`. O teste será aberto em uma nova janela. +- Verifique se seus dispositivos preferidos de alto-falante, microfone e câmera aparecem nos menus suspensos e clique em `Iniciar teste`. + +![Verifique o microfone e a webcam com o Slack](images/slack_call_test.png) + +:heavy_check_mark: Quando o teste terminar, você deverá ver mensagens verdes de "Sucesso" pelo menos para seu microfone e câmera. :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +Você também pode instalar o aplicativo Slack no seu telefone e entrar em `lewagon-alumni`! diff --git a/_partials/pt/sqlite.md b/_partials/pt/sqlite.md new file mode 100644 index 00000000..4ec4ca39 --- /dev/null +++ b/_partials/pt/sqlite.md @@ -0,0 +1,19 @@ +## SQLite + +Em algumas semanas falaremos sobre bancos de dados e SQL. [SQLite](https://sqlite.org/index.html) é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +sudo apt-get install sqlite3 libsqlite3-dev +``` + +Em seguida, execute o seguinte comando: + +```bash +sqlite3 -version +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** diff --git a/_partials/pt/ssh_agent.md b/_partials/pt/ssh_agent.md new file mode 100644 index 00000000..58355198 --- /dev/null +++ b/_partials/pt/ssh_agent.md @@ -0,0 +1,15 @@ +## Desativar prompt de senha SSH + +Você não quer que sua senha seja solicitada sempre que se comunicar com um repositório distante. Então, você precisa adicionar o plugin `ssh-agent` ao `oh my zsh`: + +Primeiro, abra o arquivo `.zshrc`: + +```bash +code ~/.zshrc +``` + +Então: +- Identifique a linha que começa com `plugins=` +- Adicione `ssh-agent` no final da lista de plugins + +:heavy_check_mark: Salve o arquivo `.zshrc` com `Ctrl` + `S` e feche seu editor de texto. diff --git a/_partials/pt/ubuntu_postgresql.md b/_partials/pt/ubuntu_postgresql.md new file mode 100644 index 00000000..0b46434b --- /dev/null +++ b/_partials/pt/ubuntu_postgresql.md @@ -0,0 +1,15 @@ +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential +``` + +```bash +sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;" +``` diff --git a/_partials/pt/ubuntu_settings.md b/_partials/pt/ubuntu_settings.md new file mode 100644 index 00000000..72693948 --- /dev/null +++ b/_partials/pt/ubuntu_settings.md @@ -0,0 +1,51 @@ +## Configurações do Ubuntu + +### Instale o codec de vídeo H264 + +Na nossa plataforma pedagógica (Kitt, você vai descobrir em breve!), temos alguns vídeos. Por padrão, o Firefox no Linux não pode reproduzi-los porque eles usam um codec não suportado (H264). Para que esses vídeos funcionem para você, você precisa executar o seguinte: + +```bash +sudo apt install libavcodec-extra -y +``` + +### Instale ferramentas de terminal úteis + +`tree` é uma boa ferramenta para visualizar uma árvore de diretórios dentro do terminal: + +`ncdu` é um utilitário de disco de interface baseado em texto. + +`htop` é um visualizador de processos interativo. + +`tig` é uma interface em modo texto para `git`. + +```bash +sudo apt install tree ncdu htop tig +``` + +### Ubuntu inotify + +O Ubuntu está sempre rastreando alterações em suas pastas e para isso usa o inotify. +Por padrão, o limite do Ubuntu é definido para 8.192 arquivos monitorados. + +Como a programação envolve muitos arquivos, precisamos aumentar esse limite. +Em seu terminal, execute: + +```bash +echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p +``` + +### Fixe aplicativos no seu dock + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Então, vamos fixá-los no seu dock para que fiquem a apenas um clique de distância! + +Para fixar um aplicativo no seu dock, inicie o aplicativo, clique com o botão direito no ícone do dock para abrir o menu de contexto e escolha "Adicionar aos Favoritos". + +![Como fixar um aplicativo no dock no Ubuntu](images/ubuntu_dock.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack +- Zoom diff --git a/_partials/pt/ubuntu_slack.md b/_partials/pt/ubuntu_slack.md new file mode 100644 index 00000000..9a912a4e --- /dev/null +++ b/_partials/pt/ubuntu_slack.md @@ -0,0 +1,9 @@ +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://get.slack.help/hc/en-us/articles/212924728-Slack-for-Linux-beta-) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. diff --git a/_partials/pt/ubuntu_vscode.md b/_partials/pt/ubuntu_vscode.md new file mode 100644 index 00000000..5d3f1c73 --- /dev/null +++ b/_partials/pt/ubuntu_vscode.md @@ -0,0 +1,47 @@ +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +Copie (`Ctrl` + `C`) os comandos abaixo e cole-os em seu terminal (`Ctrl` + `Shift` + `v`): + +```bash +wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg +``` + +```bash +sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/ +``` + +```bash +sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list' +``` + +```bash +rm -f packages.microsoft.gpg +``` + +```bash +sudo apt update +``` + +```bash +sudo apt install -y code +``` + +Esses comandos solicitarão sua senha: digite-a. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +### Iniciando a partir do terminal + +Agora vamos iniciar o VS Code no **terminal**: + +```bash +code +``` + +:heavy_check_mark: Se uma janela do VS Code acabou de abrir, você está pronto: +1: + +:x: Caso contrário, por favor **entre em contato com um professor** diff --git a/_partials/pt/vscode_extensions.md b/_partials/pt/vscode_extensions.md new file mode 100644 index 00000000..76c89610 --- /dev/null +++ b/_partials/pt/vscode_extensions.md @@ -0,0 +1,29 @@ +## Extensões do VS Code + +### Instalação + +Vamos instalar algumas extensões úteis no VS Code. + +Copie e cole os seguintes comandos em seu terminal: + +```bash +code --install-extension ms-vscode.sublime-keybindings +code --install-extension emmanuelbeziat.vscode-great-icons +code --install-extension github.github-vscode-theme +code --install-extension MS-vsliveshare.vsliveshare +code --install-extension rebornix.ruby +code --install-extension dbaeumer.vscode-eslint +code --install-extension Rubymaniac.vscode-paste-and-indent +code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +``` + +Aqui está uma lista das extensões que você está instalando: + +- [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) +- [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) +- [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) +- [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) +- [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) diff --git a/_partials/pt/vscode_liveshare.md b/_partials/pt/vscode_liveshare.md new file mode 100644 index 00000000..8d7308b9 --- /dev/null +++ b/_partials/pt/vscode_liveshare.md @@ -0,0 +1,16 @@ +### Configuração do Live Share + +[Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) é uma extensão do VS Code que permite compartilhar o código em seu editor de texto para depuração e programação em pares: vamos configurá-lo acima! + +Inicie o VS Code em seu terminal digitando `code` e pressionando `Enter`. + +Clique na pequena seta na parte inferior da barra esquerda: point_down: + +![VS Code Live Share](images/vscode_live_share.png) + +- Clique no botão "Compartilhar" e depois em "GitHub (faça login usando a conta GitHub)". +- Um pop-up aparece solicitando que você faça login no GitHub: clique em “Permitir”. +- Você é redirecionado para uma página do GitHub em seu navegador solicitando autorização do Visual Studio Code: clique em "Continuar" e depois em "Autorizar github". +- O VS Code pode exibir pop-ups adicionais: feche-os clicando em "OK". + +É isso, você está pronto para ir! diff --git a/_partials/pt/windows_browser.md b/_partials/pt/windows_browser.md new file mode 100644 index 00000000..542dfe9b --- /dev/null +++ b/_partials/pt/windows_browser.md @@ -0,0 +1,114 @@ +## Vinculando seu navegador padrão ao Ubuntu + +Para ter certeza de que você pode interagir com seu navegador instalado no Windows a partir do terminal Ubuntu, precisamos defini-lo como navegador padrão. + +:warning: Você precisa executar pelo menos um dos seguintes comandos abaixo: + +
+ Google Chrome como navegador padrão + + Execute o comando: + + ```bash + ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exe + ``` + + Você recebeu um erro como `ls: não é possível acessar...`? + +
+ Sim, ocorreu um erro + +Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc + ``` +
+ +
+ Não, estava tudo bem + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc + ``` +
+ +--- + +
+ +
+ Mozilla Firefox como seu navegador padrão + + Execute o comando: + + ```bash + ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exe + ``` + + Você recebeu um erro como `ls: não é possível acessar...`? + +
+ Sim, ocorreu um erro + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc + ``` + +
+ +
+ Não, estava tudo bem + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc + ``` +
+ +--- + +
+ +
+ Microsoft Edge como navegador padrão + + Execute os comandos: + + ```bash + echo "export BROWSER='\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"'" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc + ``` + +--- + +
+ +Reinicie seu terminal. + +Em seguida, certifique-se de que o seguinte comando retorne "Browser Defined 👌": + +```bash +[ -z "$BROWSER" ] && echo "ERROR: please define a BROWSER environment variable ⚠️" || echo "Browser defined 👌" +``` + +Se isso não acontecer, + +:heavy_check_mark: Se você recebeu esta mensagem, pode continuar :+1: + +:x: Caso contrário, escolha um navegador na lista acima e execute o comando correspondente. Então não se esqueça de redefinir seu terminal: + +```bash +exec zsh +``` + +Não hesite em **entrar em contato com um professor**. diff --git a/_partials/pt/windows_postgresql.md b/_partials/pt/windows_postgresql.md new file mode 100644 index 00000000..047ce127 --- /dev/null +++ b/_partials/pt/windows_postgresql.md @@ -0,0 +1,39 @@ +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential +``` + +```bash +sudo /etc/init.d/postgresql start +``` + +```bash +sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;" +``` + +Você pode configurar o PostgreSQL para inicialização automática, para que não precise executar `sudo /etc/init.d/postgresql start` cada vez que abrir um novo terminal: + +```bash +sudo echo "`whoami` ALL=NOPASSWD:/etc/init.d/postgresql start" | sudo tee /etc/sudoers.d/postgresql +``` + +```bash +sudo chmod 440 /etc/sudoers.d/postgresql +``` + +```bash +echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc +``` + +Abra um novo terminal. + +:heavy_check_mark: Se você vir uma mensagem `* Iniciando o servidor de banco de dados PostgreSQL 14`, você está pronto para prosseguir :+1: + +:x: Caso contrário, **entre em contato com um professor**. diff --git a/_partials/pt/windows_settings.md b/_partials/pt/windows_settings.md new file mode 100644 index 00000000..c9124bd7 --- /dev/null +++ b/_partials/pt/windows_settings.md @@ -0,0 +1,52 @@ +## Configurações do Windows + +### Troque arquivos entre Windows e Ubuntu + +Precisamos de uma maneira fácil de transferir arquivos do Windows para o Ubuntu e vice-versa. + +Para fazer isso, vamos criar atalhos para diretórios do Ubuntu no **File Explorer** do Windows: +- Abra o Windows File Explorer (ou use o atalho `WIN` + `E`) +- Na barra de endereços, digite `\\wsl$\` (ou `\\wsl$\Ubuntu` se não funcionar) +- Agora você tem acesso ao sistema de arquivos Ubuntu +- Mergulhe no sistema de arquivos Ubuntu para procurar diretórios de interesse +- Arraste as pastas desejadas para a barra de endereços para criar atalhos + +![Como adicionar um atalho ao sistema de arquivos Ubuntu no Windows](images/windows_ubuntu_file_system_shortcut.gif) + +### Abra o Windows File Explorer no terminal Ubuntu + +Outra opção para mover arquivos é abrir o Windows **File Explorer** no terminal Ubuntu: +- Abra um terminal Ubuntu +- Vá para o diretório que deseja explorar +- Execute o comando `explorer.exe .` (alternativamente, use `wslview .`) +- Se você receber uma mensagem de erro de entrada e saída, execute `wsl --shutdown` em um Windows PowerShell e reabra um terminal Ubuntu + +![Como iniciar o Windows Explorer a partir do terminal Ubuntu](images/windows_explorer_from_terminal.png) + +### Encontre o seu caminho no sistema de arquivos Ubuntu + +Você pode querer descobrir a localização exata de um diretório do Windows no sistema de arquivos Ubuntu ou vice-versa. + +Para converter um caminho do Windows de e para um caminho do Ubuntu: +- Abra um terminal Ubuntu +- Use o comando `wslpath "C:\Program Files"` para traduzir um caminho do Windows em um caminho do Ubuntu +- Use o comando `wslpath -w "/home"` para traduzir um caminho do Ubuntu em um caminho do Windows +- Em particular, o comando `wslpath -w $(pwd)` retorna o caminho do Windows do diretório atual do Ubuntu + +![Como acessar um caminho do Windows a partir do terminal Ubuntu](images/windows_path_from_terminal.png) + +### Fixe aplicativos na sua barra de tarefas + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Vamos fixá-los na barra de tarefas para que estejam a apenas um clique de distância! + +Para fixar um aplicativo na barra de tarefas, inicie o aplicativo, clique com o botão direito no ícone da barra de tarefas para abrir o menu de contexto e escolha “Fixar na barra de tarefas”. + +![Como fixar um aplicativo na barra de tarefas do Windows](images/windows_taskbar.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack +- Zoom diff --git a/_partials/pt/windows_slack.md b/_partials/pt/windows_slack.md new file mode 100644 index 00000000..525bfabb --- /dev/null +++ b/_partials/pt/windows_slack.md @@ -0,0 +1,9 @@ +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://slack.com/downloads/windows) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. diff --git a/_partials/pt/windows_terminal.md b/_partials/pt/windows_terminal.md new file mode 100644 index 00000000..c4da97b6 --- /dev/null +++ b/_partials/pt/windows_terminal.md @@ -0,0 +1,80 @@ +## Terminal do Windows + +### Instalação + +:information_source: As instruções a seguir dependem da sua versão do Windows. + +Se você estiver executando o Windows 11, o Terminal do Windows já está instalado e você pode prosseguir para a próxima seção: point_down: + +Se você estiver executando o Windows 10, vamos instalar o Windows Terminal, um terminal realmente moderno: + +- Clique em `Iniciar` +- Digite `Microsoft Store` +- Clique em `Microsoft Store` na lista +- Procure por `Windows Terminal` na barra de pesquisa +- **Selecione Terminal do Windows"** +- Clique em `Instalar` + +:warning: NÃO instale o **Windows Terminal Preview**, apenas o **Windows Terminal**! + +
+ Desinstale a versão errada do Terminal do Windows + + Para desinstalar uma versão errada do Terminal Windows, basta ir até a Lista de Programas Instalados do Windows 10: + + - Pressione `Windows` + `R` + - Digite `ms-settings:appsfeatures` + - Pressione `Enter` + + Encontre o software para desinstalar e clique no botão desinstalar. +
+ +Assim que a instalação for concluída, o botão `Instalar` se torna um botão `Iniciar`: clique nele. + +### Ubuntu como terminal padrão + +Vamos tornar o Ubuntu o terminal padrão do seu aplicativo Windows Terminal. + +Pressione `Ctrl` + `,` + +Deve abrir as configurações do terminal: + +![Configurações do Terminal do Windows](images/windows_terminal_settings.png) + +- Altere o perfil padrão para "Ubuntu" +- Clique em "Salvar" +- Clique em "Abrir arquivo JSON" + +Você pode ver um círculo laranja em vez de um pinguim como logotipo do Ubuntu. + +Temos um círculo em vermelho na parte que você irá alterar: + +![Arquivo de configurações JSON do Terminal do Windows](images/windows_terminal_settings_json.png) + +Primeiro, vamos pedir ao Ubuntu para iniciar diretamente dentro do diretório inicial do Ubuntu, em vez do diretório do Windows: +- Localize a entrada com `"name": "Ubuntu",` e `"hidden": false,` +- Adicione a seguinte linha depois dela: + +```bash +"commandline": "wsl.exe ~", +``` + +:warning: Não esqueça a vírgula no final da linha! + +Então, vamos desabilitar o aviso para comandos de copiar e colar entre o Windows e o Ubuntu: +- Localize a linha `"defaultProfile": "{2c4de342-...}"` +- Adicione a seguinte linha depois dela: + +```bash +"multiLinePasteWarning": false, +``` + +:warning: Não esqueça a vírgula no final da linha! + +Você pode salvar essas alterações pressionando `Ctrl` + `S` + +:heavy_check_mark: Seu **Terminal Windows** agora está configurado :+1: + +Este terminal possui abas: você pode optar por abrir uma nova aba do terminal clicando em **+** ao lado da atual. + +**De agora em diante, toda vez que nos referirmos ao terminal ou ao console será este.** NÃO utilize mais nenhum outro terminal. diff --git a/_partials/pt/windows_ubuntu.md b/_partials/pt/windows_ubuntu.md new file mode 100644 index 00000000..78a5d2a9 --- /dev/null +++ b/_partials/pt/windows_ubuntu.md @@ -0,0 +1,115 @@ +## Ubuntu + +### Instalação + +:information_source: As instruções a seguir dependem da sua versão do Windows. Por favor, execute apenas as instruções correspondentes à sua versão :point_down: + +#### Windows 11 + +Se você estiver executando o Windows 11, após reiniciar o computador, você deverá ver uma janela de terminal informando que o WSL está retomando o processo de instalação do Ubuntu. Quando terminar, o Ubuntu será lançado. + +#### Windows 10 + +Se você estiver executando o Windows 10, vamos instalar o Ubuntu através da Microsoft Store: + +- Clique em `Iniciar` +- Digite `Microsoft Store` +- Clique em `Microsoft Store` na lista +- Procure por `Ubuntu` na barra de pesquisa +- **Selecione a versão sem nenhum número, simplesmente "Ubuntu"** +- Clique em `Obter` + +:warning: Não instale **Ubuntu 18.04 LTS** nem **Ubuntu 20.04**! + +
+ Desinstale versões erradas do Ubuntu + + Para desinstalar uma versão errada do Ubuntu, basta ir até a Lista de Programas Instalados do Windows 10: + - Pressione `Windows` + `R` + - Digite `ms-settings:appsfeatures` + - Pressione `Enter` + + Encontre o software para desinstalar e clique no botão desinstalar. +
+ +Assim que a instalação for concluída, o botão `Get` se torna um botão `Open`: clique nele. + +### Executando pela primeira vez + +Na primeira execução, serão solicitadas algumas informações: +- Escolha um nome de usuário**: + - uma palavra + - minúsculas + - sem caracteres especiais + - por exemplo: `lewagon` ou seu `nome` +- Escolha uma senha** +- Confirme sua senha + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +Você pode fechar a janela do Ubuntu agora que ele está instalado no seu computador. + +### Verifique a versão WSL do Ubuntu + +- Pressione `Windows` + `R` +- Digite `cmd` +- Pressione `Enter` + +Digite o seguinte comando: + +```bash +wsl -l -v +``` + +:heavy_check_mark: Se a versão do Ubuntu WSL for 2, você está pronto: +1: + +:x: Se a versão do Ubuntu WSL for 1, precisaremos convertê-lo para a versão 2. + +
+ Converter Ubuntu WSL V1 em V2 + + Na janela do prompt de comando, digite: + + ```bash + wsl --set-version Ubuntu 2 + ``` + + :heavy_check_mark: Após alguns segundos, você deverá receber a seguinte mensagem: `A conversão foi concluída`. + + :x: Se não funcionar, precisamos ter certeza de que os arquivos do Ubuntu não estão compactados. +
+ +
+ Verificar arquivos descompactados + + - Pressione `Windows` + `R` + - Digite `%localappdata%\Packages` + - Pressione `Enter` + - Abra a pasta chamada `CanonicalGroupLimited.UbuntuonWindows...` + - Clique com o botão direito na pasta `LocalState` + - Clique em `Propriedades` + - Clique em `Avançado` + - Certifique-se de que a opção `Compactar conteúdo` **não** esteja marcada e clique em `Ok`. + + Aplique as alterações apenas nesta pasta e tente converter a versão WSL do Ubuntu novamente. + + :x: Se a conversão ainda não funcionar, por favor **entre em contato com um professor**. +
+ +### Verifique a localidade + +A localidade é um mecanismo que permite personalizar programas de acordo com seu idioma e país. + +Vamos verificar se a localidade padrão está definida como inglês, digite isto no terminal do Ubuntu: + +```bash +locale +``` + +Se a saída não contiver `LANG=en_US.UTF-8`, execute o seguinte comando em um terminal Ubuntu para instalar a localidade em inglês: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Agora você pode fechar esta janela do terminal. diff --git a/_partials/pt/windows_version.md b/_partials/pt/windows_version.md new file mode 100644 index 00000000..c14b1f3e --- /dev/null +++ b/_partials/pt/windows_version.md @@ -0,0 +1,72 @@ +## Versão do Windows + +Antes de começarmos, precisamos verificar se a versão do Windows instalada no seu computador é compatível com estas instruções de configuração. + +### Windows 10 ou Windows 11 + +Para poder configurar seu computador, você precisa ter o **Windows 10 ou Windows 11** instalado. + +Para verificar sua versão do Windows: +- Pressione `Windows` + `R` +- Digite `winver` +- Pressione `Enter` + +:heavy_check_mark: Se as primeiras palavras desta janela forem **Windows 10 ou Windows 11** você está pronto para prosseguir :+1: + +:x: Caso contrário, você não poderá prosseguir com esta configuração. Você precisa atualizar para o Windows 10 primeiro: point_down: + +
+ Atualizar para o Windows 10 + + - Baixe o Windows 10 da [Microsoft](https://www.microsoft.com/software-download/windows10ISO) + - Instale-o. Deve demorar cerca de uma hora, mas isso depende do seu computador. + - Quando a instalação terminar, execute os comandos acima :point_up: para verificar se você agora tem o **Windows 10**. +
+ +:information_source: [A atualização do Windows 11 está sendo lançada agora](https://www.microsoft.com/en-us/windows/get-windows-11), o que significa que ela pode ou não estar disponível para o seu computador ainda . + +:warning: **Se você tiver o Windows 10 instalado, não será necessário atualizar para o Windows 11 para prosseguir com esta configuração**. + +### Ultimas atualizações + +Quando tiver certeza de que está usando o Windows 10 ou 11, você precisará instalar todas as atualizações mais recentes. + +Abra a atualização do Windows: +- Pressione `Windows` + `R` +- Digite `ms-settings:windowsupdate` +- Pressione `Enter` +- Clique em `Verificar atualizações` + +:heavy_check_mark: Se você vir uma marca de seleção verde e a mensagem "Você está atualizado", você está pronto para prosseguir :+1: + +:warning: Se você tiver um ponto de exclamação vermelho e a mensagem "Atualização disponível", instale-os e repita o processo até que apareça que você está atualizado :loop: + +:x: Se você receber uma mensagem de erro sobre o Windows não conseguir aplicar atualizações, **entre em contato com um professor**. + +
+ Ative o Windows Update Service para corrigir atualizações + + Alguns antivírus e softwares desativam o serviço de atualização de que precisamos, resultando no erro que você vê. Vamos consertar isso! + - Pressione `Windows` + `R` + - Digite `services.msc` + - Pressione `Enter` + - Clique duas vezes em `Serviço de atualização do Windows` + - Defina sua `Inicialização` para `Automático` + - Clique em `Iniciar` + - Clique em `Ok` + Então vamos tentar as atualizações novamente! +
+ +### Versão mínima + +Algumas das ferramentas que precisamos instalar foram lançadas com a versão `1903` **ou superior** do Windows 10, então precisamos ter certeza de que você tem pelo menos esta. + +- Pressione `Windows` + `R` +- Digite `winver` +- Pressione `Enter` + +Verifique o **Número da versão**: + +:heavy_check_mark: Se disser pelo menos `1903`, você está pronto :+1: + +:x: Se estiver abaixo de `1903`, por favor **entre em contato com um professor**. diff --git a/_partials/pt/windows_virtualization.md b/_partials/pt/windows_virtualization.md new file mode 100644 index 00000000..8746e434 --- /dev/null +++ b/_partials/pt/windows_virtualization.md @@ -0,0 +1,37 @@ +## Virtualização + +Precisamos garantir que as opções de virtualização estejam habilitadas no BIOS do seu computador. + +Para muitos computadores, este já é o caso. Vamos checar: +- Pressione `Windows` + `R` +- Digite `taskmgr` +- Pressione `Enter` +- Clique na aba `Desempenho` +- Clique em `CPU` + +![Gerenciador de tarefas do Windows](images/windows_task_manager.png) + +:heavy_check_mark: Se você vir "Virtualização: Ativada", está pronto: +1: + +:x: Se a linha estiver faltando ou se a virtualização estiver desabilitada, por favor **entre em contato com um professor antes de tentar ativar a Virtualização** + +
+ Ativar virtualização + + Precisamos acessar o BIOS/UEFI do computador para ativá-lo. + - Pressione `Windows + R` + - Digite `shutdown.exe /r /o /t 1` + - Pressione `Enter` + - Aguarde o computador desligar + - Clique em `Solucionar problemas` + - Clique em `Opções avançadas` + - Clique em `Configurações de firmware UEFI` + - Clique em `Reiniciar` + + Você precisa ativar a opção de virtualização para o seu processador aqui: + - Na maioria das vezes, nas configurações avançadas, nas configurações da CPU ou nas configurações do Northbridge + - A opção pode ter um nome diferente de acordo com o seu computador: + - Intel: `Intel VT-x`, `Tecnologia de virtualização Intel`, `Extensões de virtualização`, `Vanderpool`... + - AMD: `Modo SVM` ou `AMD-V` + - Salve as alterações após a ativação e reinicie o computador através da opção apropriada +
diff --git a/_partials/pt/windows_vscode.md b/_partials/pt/windows_vscode.md new file mode 100644 index 00000000..2fd963d2 --- /dev/null +++ b/_partials/pt/windows_vscode.md @@ -0,0 +1,38 @@ +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +- Vá para a [página de download do Visual Studio Code](https://code.visualstudio.com/download). +- Clique no botão "Windows" +- Abra o arquivo que você acabou de baixar. +- Instale-o com algumas opções: + +![Opções de instalação do VS Code](images/windows_vscode_installation.png) + +Quando a instalação for concluída, inicie o VS Code. + +### Conectando o código VS ao Ubuntu + +Para fazer o VS Code interagir corretamente com o Ubuntu, vamos instalar a extensão [Remote - WSL](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl) VS Code. + +Abra seu **terminal Ubuntu**. + +Copie e cole os seguintes comandos no terminal: + +```bash +code --install-extension ms-vscode-remote.remote-wsl +``` + +Em seguida, abra o VS Code em seu terminal: + +```bash +code . +``` + +:heavy_check_mark: Se você vir `WSL: Ubuntu` no canto inferior esquerdo da janela do VS Code, você está pronto para prosseguir :+1: + +![WSL Ubuntu remoto](images/windows_remote_wsl.png) + +:x: Caso contrário, por favor **entre em contato com um professor** diff --git a/_partials/pt/windows_wsl.md b/_partials/pt/windows_wsl.md new file mode 100644 index 00000000..1cb730ec --- /dev/null +++ b/_partials/pt/windows_wsl.md @@ -0,0 +1,116 @@ +## Subsistema Windows para Linux (WSL) + +WSL é o ambiente de desenvolvimento que usamos para executar o Ubuntu. Você pode aprender mais sobre WSL [aqui](https://docs.microsoft.com/en-us/windows/wsl/faq). + +:information_source: As instruções a seguir dependem da sua versão do Windows. Por favor, execute apenas as instruções correspondentes à sua versão :point_down: + +### Windows 11 + +Se você estiver executando o Windows 11, instalaremos o WSL 2 e o Ubuntu em um comando através do Terminal do Windows. + +:warning: Nas instruções a seguir, esteja ciente do pressionamento de tecla `Ctrl` + `Shift` + `Enter` para executar o **Terminal Windows** com privilégios de administrador em vez de apenas clicar em `Ok` ou pressionar `Enter` . + +- Pressione `Windows` + `R` +- Digite `wt` +- Pressione **`Ctrl` + `Shift` + `Enter`** + +:warning: Você pode ter que aceitar a confirmação do UAC sobre a elevação de privilégio. + +Uma janela de terminal azul aparecerá: +- Copie o seguinte comando (`Ctrl` + `C`) +- Cole-o na janela do terminal (`Ctrl` + `V` ou clicando com o botão direito na janela) +- Execute-o pressionando `Enter` + +```powershell +wsl --install +``` + +:heavy_check_mark: Se o comando foi executado sem nenhum erro, reinicie o computador e continue abaixo:+1: + +:x: Se você encontrar uma mensagem de erro (ou se vir algum texto em vermelho na janela), por favor **entre em contato com um professor** + +### Windows 10 + +#### Instale o WSL 1 + +Se você estiver executando o Windows 10, primeiro instalaremos o WSL 1 por meio do Terminal PowerShell. + +:warning: Nas instruções a seguir, esteja ciente do pressionamento de tecla `Ctrl` + `Shift` + `Enter` para executar o **Windows PowerShell** com privilégios de administrador em vez de apenas clicar em `Ok` ou pressionar `Enter` . + +- Pressione `Windows` + `R` +- Digite `powershell` +- Pressione **`Ctrl` + `Shift` + `Enter`** + +:warning: Você pode ter que aceitar a confirmação do UAC sobre a elevação de privilégio. + +Uma janela de terminal azul aparecerá: +- Copie os seguintes comandos um por um (`Ctrl` + `C`) +- Cole-os na janela do PowerShell (`Ctrl` + `V` ou clicando com o botão direito na janela) +- Execute-os pressionando `Enter` + +```powershell +Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux +``` + +```powershell +dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart +``` + +```powershell +dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart +``` + +:heavy_check_mark: Se todos os três comandos foram executados sem nenhum erro, reinicie o computador e continue abaixo:+1: + +:x: Se você encontrar uma mensagem de erro (ou se vir algum texto em vermelho na janela), por favor **entre em contato com um professor** + +#### Atualizar para WSL 2 + +Se você estiver executando o Windows 10, atualizaremos o WSL para a versão 2. + +Assim que o computador for reiniciado, precisamos baixar o instalador WSL2. + +- Vá para a [página de download](https://aka.ms/wsl2kernel) +- Baixe o "pacote de atualização do kernel WSL2 Linux" +- Abra o arquivo que você acabou de baixar +- Clique em `Avançar` +- Clique em `Concluir` + +![Atualize WSL da versão 1 para 2](images/windows_update_wsl.png) + +:heavy_check_mark: Se não encontrou nenhuma mensagem de erro, você está pronto: +1: + +:x: Se você encontrar o erro "Esta atualização se aplica apenas a máquinas com o subsistema Windows para Linux", **clique com o botão direito** no programa e selecione `uninstall`; você poderá instalá-lo normalmente desta vez. + +#### Torne o WSL 2 o subsistema Windows padrão para Linux + +Se você estiver executando o Windows 10, definiremos a versão padrão do WSL como 2. + +Agora que o WSL 2 está instalado, vamos torná-lo a versão padrão: +- Pressione `Windows` + `R` +- Digite `cmd` +- Pressione `Enter` + +Na janela que aparece, digite: + +```bash +wsl --set-default-version 2 +``` + +:heavy_check_mark: Se você vir "A operação foi concluída com sucesso", você pode fechar este terminal e continuar seguindo as instruções abaixo:+1: + +:x: Se a mensagem que você receber for sobre Virtualização, por favor **entre em contato com um professor** + +
+ Ativar recurso Windows da Plataforma de Máquina Virtual + + Siga as etapas descritas [aqui](https://www.configserverfirewall.com/windows-10/please-enable-the-virtual-machine-platform-windows-feature-and-ensure-virtualization-is-enabled-in- the-bios/#:~:text=To%20enable%20WSL%202,%20Open,Windows%20feature%20on%20or%20off.&text=Garanta%20que%20the%20Virtual%20Machine,Windows%20will%20enable%20WSL %202) até você ativar a Plataforma de Máquina Virtual e o Subsistema Windows para Linux +
+ +
+ Ativar recurso Hyper-V do Windows + + Siga as etapas descritas [aqui](https://winaero.com/enable-use-hyper-v-windows-10/) até ativar o grupo Hyper-V + + :information_source: Se você estiver executando o Windows 10 **Home edition**, o recurso Hyper-V não estará disponível para o seu sistema operacional. Não bloqueia e você ainda pode continuar seguindo as instruções abaixo: ok_hand: +
diff --git a/_partials/pt/yarn.md b/_partials/pt/yarn.md new file mode 100644 index 00000000..f80f7c48 --- /dev/null +++ b/_partials/pt/yarn.md @@ -0,0 +1,23 @@ +## fio + +[`yarn`](https://yarnpkg.com/) é um gerenciador de pacotes para instalar bibliotecas JavaScript. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +npm install --global yarn +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +yarn -v +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** diff --git a/_partials/pt/zoom.md b/_partials/pt/zoom.md new file mode 100644 index 00000000..a1b3f3e1 --- /dev/null +++ b/_partials/pt/zoom.md @@ -0,0 +1,29 @@ +## Zoom + +Para poder interagir quando não estivermos na mesma sala física, usaremos o [Zoom](https://zoom.us/), uma ferramenta de videoconferência. + +:warning: Se você já possui o Zoom instalado, certifique-se de que a versão seja pelo menos **5.6**. + +Acesse [zoom.us/download](https://zoom.us/download). + +Em **Cliente Zoom** clique no botão **Baixar**. + +Abra o arquivo que você acabou de baixar para instalar o aplicativo. + +Abra o aplicativo Zoom. + +Se você já possui uma conta Zoom, faça login usando suas credenciais. + +Caso contrário, clique no link **Cadastre-se gratuitamente**: + +![Cadastre-se gratuitamente para ampliar](images/zoom_sign_up_free.png) + +Você será redirecionado ao site do Zoom para preencher um formulário. + +Quando terminar, volte para o aplicativo Zoom e faça login usando suas credenciais. + +Você deverá então ver uma tela como esta: + +![Zoom tela inicial](images/zoom_home_screen.png) + +Agora você pode fechar o aplicativo Zoom. diff --git a/build.rb b/build.rb index 5e2046a6..47c5f2f6 100755 --- a/build.rb +++ b/build.rb @@ -95,7 +95,7 @@ "ubuntu.md" => UBUNTU } -["", "cn", "es", "fr"].each do |locale| +["", "cn", "es", "fr", "pt"].each do |locale| SETUPS.each do |filename, partials| filename = "#{filename.split(".md").first}.#{locale}.md" unless locale.empty? File.open(filename, "w:utf-8") do |f| diff --git a/macos.pt.md b/macos.pt.md new file mode 100644 index 00000000..449449d8 --- /dev/null +++ b/macos.pt.md @@ -0,0 +1,755 @@ +# Instruções de configuração + +Você encontrará abaixo as instruções para configurar seu computador para o [curso de Desenvolvimento Web da Le Wagon](https://www.lewagon.com/web-development-course/full-time). + +Por favor, **leia com atenção e execute todos os comandos na seguinte ordem**. + +Se você tiver dúvidas, não hesite em pedir ajuda a um professor :raising_hand: + +Você também pode dar uma olhada em [nossas cheatsheets](https://github.com/lewagon/setup/tree/master/docs) para soluções e dicas de problemas comuns :heavy_check_mark: + +Vamos começar :rocket: + +## Zoom + +Para poder interagir quando não estivermos na mesma sala física, usaremos o [Zoom](https://zoom.us/), uma ferramenta de videoconferência. + +:warning: Se você já possui o Zoom instalado, certifique-se de que a versão seja pelo menos **5.6**. + +Acesse [zoom.us/download](https://zoom.us/download). + +Em **Zoom Client** clique no botão **Download**. + +Abra o arquivo que você acabou de baixar para instalar o aplicativo. + +Abra o aplicativo Zoom. + +Se você tiver um Mac com Apple Silicon, [você será solicitado a instalar o Rosetta](https://support.apple.com/en-us/HT211861). Clique em Instalar e digite seu nome de usuário e senha para permitir que a instalação continue. + +![Instale o Rosetta](https://support.apple.com/library/content/dam/edam/applecare/images/en_US/macos/Big-Sur/macos-big-sur-software-update-rosetta-alert. jpg) + +Se você já possui uma conta Zoom, faça login usando suas credenciais. + +Caso contrário, clique no link **Inscreva-se Gratuitamente**: + +![Cadastre-se gratuitamente no Zoom](images/zoom_sign_up_free.png) + +Você será redirecionado ao site do Zoom para preencher um formulário. + +Quando terminar, volte para o aplicativo Zoom e faça login usando suas credenciais. + +Você deverá então ver uma tela como esta: + +![Zoom tela inicial](images/zoom_home_screen.png) + +Agora você pode fechar o aplicativo Zoom. + +## Conta no GitHub + +Você se inscreveu no GitHub? Caso contrário, [faça isso imediatamente](https://github.com/join). + +:point_right: **[Carregue uma imagem](https://github.com/settings/profile)** e coloque seu nome corretamente em sua conta GitHub. Isso é importante porque usaremos um painel interno com seu avatar. Faça isso **agora**, antes de continuar com este guia. + +![Imagem do GitHub](images/github_picture.png) + +## Uma observação sobre como encerrar aplicativos em um Mac + +Clicar na pequena cruz vermelha no canto superior esquerdo da janela do aplicativo em um Mac **não o encerra**, apenas fecha uma janela ativa. Para sair do aplicativo _de verdade_ pressione `Cmd + Q` quando o aplicativo estiver ativo ou navegue até `APP_NAME` -> `Quit` na barra de menu. + +![Sair do Terminal no macOS](images/macos_quit.png) + +Durante esta configuração, você será solicitado a **sair e reabrir** os aplicativos várias vezes. Certifique-se de fazer isso corretamente :pray: + +## Ferramentas de linha de comando + +Abra um novo terminal, copie e cole o seguinte comando e pressione `Enter`: + +```bash +xcode-select --install +``` + +Se você receber a mensagem a seguir, basta pular esta etapa e ir para a próxima. + +```bash +# ferramentas de linha de comando já estão instaladas, use "Atualização de Software" para instalar atualizações +``` + +Caso contrário, abrirá uma janela perguntando se deseja instalar algum software: clique em “Instalar” e aguarde. + + +![Instale o xcode-select no macOS](images/macos_xcode_select_install.png) + +:heavy_check_mark: Se você vir a mensagem "O software foi instalado", tudo bem :+1: + +:x: Se o comando `xcode-select --install` falhar, tente novamente: às vezes os servidores Apple ficam sobrecarregados. + +:x: Se você vir a mensagem "O Xcode não está disponível no servidor de atualização de software", será necessário atualizar o catálogo de atualização de software: + +```bash +sudo softwareupdate --clear-catalog +``` + +Feito isso, você pode tentar instalar novamente. + +## Homebrew + +[Homebrew](http://brew.sh/) é um gerenciador de pacotes: é um software usado para instalar outros softwares a partir da linha de comando. Vamos instalá-lo! + +Abra um terminal e execute: + +```bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" +``` + +Isso solicitará sua confirmação (pressione `Enter`) e sua **senha da conta de usuário do macOS** (aquela que você usa para [fazer login](https://support.apple.com/en-gb/HT202860) quando você reinicia seu Macbook). + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +:warning: Se você vir este aviso :point_down:, execute os dois comandos na seção `Próximas etapas` para adicionar o Homebrew ao seu PATH: + +![Aviso de instalação do macOS Homebrew](images/macos_homebrew_warning.png) + +```bash +# ⚠️ Execute esses comandos apenas se você viu este aviso ☝ +echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile +eval "$(/opt/homebrew/bin/brew shellenv)" +``` + +Se você já tem o Homebrew, ele lhe dirá, tudo bem, vá em frente. + +Em seguida, instale algum software útil: + +```bash +brew update +``` + +Se você receber um erro `/usr/local deve ser gravável`, basta executar isto: + +```bash +sudo chown -R $USER:admin /usr/local +``` + +```bash +brew update +``` + +Continue executando o seguinte no terminal (você pode copiar/colar todas as linhas de uma vez). + +```bash +brew upgrade git || brew install git +``` + +```bash +brew upgrade gh || brew install gh +``` + +```bash +brew upgrade wget || brew install wget +``` + +```bash +brew upgrade imagemagick || brew install imagemagick +``` + +```bash +brew upgrade jq || brew install jq +``` + +```bash +brew upgrade openssl || brew install openssl +``` + +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +Copie (`Cmd` + `C`) o comando abaixo e cole-o em seu terminal (`Cmd` + `V`): + +```bash +brew install --cask visual-studio-code +``` + +Em seguida, inicie o VS Code executando o seguinte comando em seu terminal: + +```bash +code +``` + +:heavy_check_mark: Se uma janela do VS Code acabou de abrir, você está pronto: +1: + +:x: Caso contrário, por favor, **entre em contato com um professor** + + +## Extensões do VS Code + +### Instalação + +Vamos instalar algumas extensões úteis no VS Code. + +Copie e cole os seguintes comandos em seu terminal: + +```bash +code --install-extension ms-vscode.sublime-keybindings +code --install-extension emmanuelbeziat.vscode-great-icons +code --install-extension github.github-vscode-theme +code --install-extension MS-vsliveshare.vsliveshare +code --install-extension rebornix.ruby +code --install-extension dbaeumer.vscode-eslint +code --install-extension Rubymaniac.vscode-paste-and-indent +code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +``` + +Aqui está uma lista das extensões que você está instalando: + +- [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) +- [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) +- [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) +- [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) +- [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) + +### Configuração do Live Share + +[Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) é uma extensão do VS Code que permite compartilhar o código em seu editor de texto para depuração e programação em pares: vamos configurá-lo acima! + +Inicie o VS Code em seu terminal digitando `code` e pressionando `Enter`. + +Clique na pequena seta na parte inferior da barra esquerda: point_down: + +![VS Code Live Share](images/vscode_live_share.png) + +- Clique no botão "Compartilhar" e depois em "GitHub (faça login usando a conta GitHub)". +- Um pop-up aparece solicitando que você faça login no GitHub: clique em “Permitir”. +- Você é redirecionado para uma página do GitHub em seu navegador solicitando autorização do Visual Studio Code: clique em "Continuar" e depois em "Autorizar github". +- O VS Code pode exibir pop-ups adicionais: feche-os clicando em "OK". + +É isso, você está pronto para ir! + + +## Tema do Terminal macOS + +Inicie um terminal, clique em `Terminal > Preferências` e defina o tema "Pro" como perfil padrão. + +![Definir tema Pro para terminal macOS](images/macos_terminal_pro.png) + +Na guia Janela, defina também seu **Tamanho da janela** para Colunas: 200, Linhas: 50 + +**Saia e reinicie** seu terminal: agora ele deve ter um belo fundo preto, mais agradável aos olhos. + +## Oh-my-zsh + +Vamos instalar o plugin `zsh` [Oh My Zsh](https://ohmyz.sh/). + +Em um terminal execute o seguinte comando: + +```bash +sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" +``` + +Se for perguntado "Deseja alterar seu shell padrão para zsh?", pressione `Y` + +No final seu terminal deverá ficar assim: + +![Terminal Ubuntu com OhMyZsh](images/oh_my_zsh.png) + +:heavy_check_mark: Se isso acontecer, você pode continuar :+1: + +:x: Caso contrário, por favor ** peça um professor ** + + +## CLI do GitHub + +CLI é o acrônimo de [Command Line Interface](https://en.wikipedia.org/wiki/Command-line_interface). + +Nesta seção, usaremos [GitHub CLI](https://cli.github.com/) para interagir com o GitHub diretamente do terminal. + +Ele já deve estar instalado no seu computador a partir dos comandos anteriores. + +Primeiro, para **fazer login**, copie e cole o seguinte comando em seu terminal: + +:warning: **NÃO edite o `email`** + +```bash +gh auth login -s 'user:email' -w +``` + +gh fará algumas perguntas: + +`What is your preferred protocol for Git operations?` With the arrows, choose `SSH` and press `Enter`. SSH é um protocolo para fazer login usando chaves SSH em vez do conhecido par nome de usuário/senha. + +`Generate a new SSH key to add to your GitHub account?` Pressione `Enter` para pedir ao gh gerar as chaves SSH para você. + +Se você já possui chaves SSH, verá `Upload your SSH public key to your GitHub account?` Com as setas, selecione o caminho do arquivo de sua chave pública e pressione `Enter`. + +`Enter a passphrase for your new SSH key (Optional)`. Digite algo que você deseja e que você lembrará. É uma senha para proteger sua chave privada armazenada no disco rígido. Em seguida, pressione `Enter`. + +`Title for your SSH key`. Você pode deixá-lo no "GitHub CLI" proposto, pressione `Enter`. + +Você obterá então a seguinte saída: + +```bash +! First copy your one-time code: 0EF9-D015 +- Press Enter to open github.com in your browser... +``` + +Selecione e copie o código (`0EF9-D015` no exemplo) e pressione `Enter`. + +Seu navegador será aberto e solicitará que você autorize o GitHub CLI a usar sua conta GitHub. Aceite e espere um pouco. + +Volte ao terminal, pressione `Enter` novamente e pronto. + +Para verificar se você está conectado corretamente, digite: + +```bash +gh auth status +``` + +:heavy_check_mark: Se você estiver `Logged in to github.com as `, então tudo bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +## Dotfiles (configuração padrão) + +Os hackers adoram refinar e aprimorar sua estrutura e ferramentas. + +Começaremos com uma ótima configuração padrão fornecida pelo Le Wagon: [`lewagon/dotfiles`](https://github.com/lewagon/dotfiles). + +Como sua configuração é pessoal, você precisa de seu próprio repositório para armazená-la. Então você irá fazer um **fork** do repositório Le Wagon. + +Bifurcar significa que você criará um novo repositório em sua própria conta GitHub `$GITHUB_USERNAME/dotfiles`, idêntico ao original do Le Wagon que você poderá modificar à vontade. + +Abra seu terminal e defina uma variável para seu nome de usuário GitHub: + +```bash +export GITHUB_USERNAME=`gh api user | jq -r '.login'` +``` + +```bash +echo $GITHUB_USERNAME +``` + +:heavy_check_mark: Você deverá ver seu nome de usuário do GitHub impresso. + +:x: Se não, **pare aqui** e peça ajuda. Pode haver um problema com a etapa anterior (`gh auth`). + +:warning: Por favor, note que esta variável só é definida para o tempo em que seu terminal está aberto. Se você fechá-lo antes ou durante as próximas etapas, será necessário configurá-lo novamente com as duas etapas acima! + + +É hora de fazer um fork do repositório e cloná-lo em seu computador: + +```bash +mkdir -p ~/code/$GITHUB_USERNAME && cd $_ +``` + +```bash +gh repo fork lewagon/dotfiles --clone +``` + +### Instalador do Dotfiles + +Execute o instalador `dotfiles`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles +``` + +```bash +zsh install.sh +``` + +Verifique os e-mails registrados em sua conta GitHub. Você precisará escolher um na próxima etapa: + +```bash +gh api user/emails | jq -r '.[].email' +``` + +:heavy_check_mark: Se você vir a lista de seus e-mails registrados, você pode prosseguir :+1: + +:x: Caso contrário, [reautentique-se no GitHub](https://github.com/lewagon/setup/blob/master/macos.md#github-cli) antes de executar este comando :point_up: novamente. + +### instalador git + +Execute o instalador `git`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh +``` + +:point_up: Isso **solicitará** seu nome (`Nome Sobrenome`) e seu e-mail. + +:warning: Você **precisa** colocar um dos e-mails listados acima graças ao comando anterior `gh api ...`. Se você não fizer isso, Kitt não conseguirá acompanhar seu progresso. + +Agora **reinicie** seu terminal executando: + +```bash +exec zsh +``` + +## rbenv + +Vamos instalar o [`rbenv`](https://github.com/sstephenson/rbenv), um software para instalar e gerenciar ambientes `ruby`. + +Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter: + +```bash +rvm implode && sudo rm -rf ~/.rvm +# Se você obteve "zsh: command not found: rvm", continue. Isso significa que `rvm` não está +# no seu computador, e é isso que queremos! + +sudo rm -rf $HOME/.rbenv /usr/local/rbenv /opt/rbenv /usr/local/opt/rbenv +``` + +:warning: Este comando pode solicitar sua senha. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +No terminal, execute: + +```bash +brew uninstall --force rbenv ruby-build +``` + +```bash +exec zsh +``` + +Então corra: + +```bash +brew install rbenv +``` + +## Ruby + +### Instalação + +Agora, você está pronto para instalar a versão mais recente do [ruby](https://www.ruby-lang.org/en/) e defini-la como a versão padrão. + +Execute este comando, **demorará um pouco (5 a 10 minutos)** + +```bash +rbenv install 3.1.2 +``` + +Assim que a instalação do Ruby estiver concluída, execute este comando para informar ao sistema +para usar a versão 3.1.2 por padrão. + +```bash +rbenv global 3.1.2 +``` + +**Reinicialize** seu terminal e verifique sua versão do Ruby: + +```bash +exec zsh +``` + +Então corra: + +```bash +ruby -v +``` + +:heavy_check_mark: Se você vir algo começando com `ruby 3.1.2p` então você pode prosseguir :+1: + +:x: Se não, **pergunte a um professor** + +### Instalando algumas gems + +
+ Se você estiver na China 🇨🇳 clique aqui + + :warning: Se você estiver na China, você deve atualizar a forma como instalaremos as gems com os seguintes comandos. + +```bash +# Somente China! +gem sources --remove https://rubygems.org/ +gem sources -a https://gems.ruby-china.com/ +gem sources -l +#***FONTES ATUAIS*** +# https://gems.ruby-china.com/ +# Ruby-china.com deve estar na lista agora +``` +
+ +**Todos, na China ou não**, continuem aqui para instalar gems. + +No mundo Ruby, chamamos bibliotecas externas de `gems`: são pedaços de código Ruby que você pode baixar e executar em seu computador. Vamos instalar alguns! + +No seu terminal, copie e cole o seguinte comando: + +```bash +gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +``` + +:heavy_check_mark: Se você tiver `xx gems installed`, então tudo bem :+1: + +:x: Se você encontrar o seguinte erro: + +```bash +ERROR: While executing gem ... (TypeError) +incompatible marshal file format (can't be read) +format version 4.8 required; 60.33 given +``` + +Execute o seguinte comando: +```bash +rm -rf ~/.gemrc +``` + +Execute novamente o comando para instalar as gems. + +:warning: **NUNCA** instale uma gem com `sudo gem install`! Mesmo se você encontrar uma resposta do Stackoverflow (ou o terminal) solicitando que você faça isso. + +## Node.js + +[Node.js](https://nodejs.org/en/) é um JavaScript runtime para executar código JavaScript no terminal. Vamos instalá-lo com [nvm](https://github.com/nvm-sh/nvm), um gerenciador de versões para Node.js. + +Em um terminal, execute os seguintes comandos: + +```bash +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +nvm -v +``` + +Você deverá ver uma versão. Se não, pergunte a um professor. + +Agora vamos instalar o Node: + +```bash +nvm install 16.15.1 +``` + +Quando a instalação terminar, execute: + +```bash +node -v +``` + +Se você vir `v16.15.1`, a instalação foi bem-sucedida: heavy_check_mark: Você pode então executar: + +```bash +nvm cache clear +``` + +:x: Caso contrário, **entre em contato com um professor** + +## Yarn + +[`yarn`](https://yarnpkg.com/) é um gerenciador de pacotes para instalar bibliotecas JavaScript. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +npm install --global yarn +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +yarn -v +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** + +## SQLite + +Em algumas semanas falaremos sobre bancos de dados e SQL. [SQLite](https://sqlite.org/index.html) é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +brew install sqlite +``` + +Em seguida, execute o seguinte comando: + +```bash +sqlite3 -version +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** + +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +brew install postgresql@15 libpq +brew link --force libpq +``` + +```bash +brew services start postgresql@15 +``` + +Depois de fazer isso, vamos verificar se funcionou: + +```bash +psql -d postgres +``` + +Você deverá ver um novo prompt como este: point_down: + +```bash +psql (15.2) +Type "help" for help. + +postgres=# +``` + +:heavy_check_mark: Se for esse o caso, digite `\q` e depois `Enter` para sair deste prompt. Você está pronto para ir: +1: + +:x: Se não, por favor ** peça um professor ** + +## Checagem + +Vamos verificar se você instalou tudo com sucesso. + +No seu terminal, execute o seguinte comando: + +```bash +exec zsh +``` + +Então rode: + +```bash +curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb +``` + +:heavy_check_mark: Se você receber uma mensagem verde `Incrível! Seu computador agora está pronto!`, então você está bem: +1: + +:x: Caso contrário, **entre em contato com um professor**. + +## Kitt + +:warning: Se você recebeu um e-mail do Le Wagon convidando você a se inscrever no Kitt (nossa plataforma de aprendizagem), você pode pular esta etapa com segurança. Em vez disso, siga as instruções no e-mail que você recebeu, caso ainda não tenha feito isso. + +Se não tiver certeza sobre o que fazer, siga [este link](https://kitt.lewagon.com/). Se você já estiver logado, pode pular esta seção com segurança. Se você não estiver logado, clique em `Enter Kitt as a Student`. Se você conseguir fazer login, poderá pular esta etapa com segurança. Caso contrário, pergunte a um professor se você deveria ter recebido um e-mail ou siga as instruções abaixo. + +Registre-se como alumni da Wagon acessando [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Selecione seu lote, faça login no GitHub e insira todas as suas informações. + +Seu professor irá então validar se você realmente faz parte do batch. Você pode pedir que eles façam isso assim que preencher o formulário de registro. + +Assim que o professor aprovar seu perfil, acesse sua caixa de entrada de e-mail. Você deve ter 2 e-mails: + +- Um do Slack, convidando você para a comunidade Le Wagon Alumni do Slack (onde você conversará com seus amigos e todos os ex-alunos anteriores). Clique em **Inscreva-se** e preencha os dados. +- Um do GitHub, convidando você para a equipe `lewagon`. **Aceite** caso contrário você não conseguirá acessar os slides da aula. + +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://itunes.apple.com/us/app/slack/id803453959?mt=12) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. + + +### Configurações + +Inicie o aplicativo e faça login na organização `lewagon-alumni`. + +Certifique-se de **fazer upload de uma foto de perfil** :point_down: + +![Como fazer upload de uma foto de perfil no Slack](images/slack_profile_picture.gif) + +A ideia é que você tenha o Slack aberto o dia todo, para que você possa compartilhar links úteis/pedir ajuda/decidir onde ir almoçar/etc. + +Para garantir que tudo está funcionando bem nas videochamadas, vamos testar sua câmera e microfone: +- Abra o aplicativo Slack +- Clique na foto do seu perfil no canto superior direito. +- Selecione `Preferências` no menu. +- Clique em `Áudio e vídeo` na coluna do lado esquerdo. +- Abaixo de `Solução de problemas`, clique em `Executar um teste de áudio, vídeo e compartilhamento de tela`. O teste será aberto em uma nova janela. +- Verifique se seus dispositivos preferidos de alto-falante, microfone e câmera aparecem nos menus suspensos e clique em `Iniciar teste`. + +![Verifique o microfone e a webcam com o Slack](images/slack_call_test.png) + +:heavy_check_mark: Quando o teste terminar, você deverá ver mensagens verdes de "Sucesso" pelo menos para seu microfone e câmera. :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +Você também pode instalar o aplicativo Slack no seu telefone e entrar em `lewagon-alumni`! + +## configurações do macOS + +### Segurança + +É obrigatório que você proteja sua sessão com uma senha. Se ainda não for o caso, vá para ` > Preferências do Sistema > Usuários e Grupos` e altere a senha da sua conta. Você também deve ir para ` > Preferências do Sistema > Segurança > Geral`. Você deve exigir uma senha `5 segundos` após o início da suspensão ou da proteção de tela. + +Você também pode ir para ` > Preferências do Sistema > Controle da Missão` e clicar no botão `Hot Corners` no canto inferior esquerdo. Escolha no canto inferior direito para iniciar o protetor de tela. Dessa forma, ao sair da mesa, você pode bloquear rapidamente a tela colocando o mouse no canto inferior direito. 5 segundos depois, seu Macbook estará bloqueado e solicitará uma senha para voltar à sessão. + +### Teclado + +Ao se tornar um programador, você entenderá que deixar o teclado leva muito tempo, então você vai querer minimizar o uso do trackpad ou do mouse. Aqui estão alguns truques no macOS para ajudá-lo a fazer isso. + +#### Velocidade do teclado + +Vá para ` > Preferências do Sistema > Teclado`. Defina `Key Repeat` para a posição mais rápida (à direita) e `Delay Until Repeat` para a posição mais curta (à direita). + +#### macOS Para hackers + +[Leia este script](https://github.com/mathiasbynens/dotfiles/blob/master/.macos) e escolha algumas coisas que você acha que combinam com você. Por exemplo, você pode digitar no terminal este: + +```bash +# Expanding the save panel by default +defaults write NSGlobalDomain NSNavPanelExpandedStateForSaveMode -bool true +defaults write NSGlobalDomain PMPrintingExpandedStateForPrint -bool true +defaults write NSGlobalDomain PMPrintingExpandedStateForPrint2 -bool true + +# Save screenshots to the Desktop (or elsewhere) +defaults write com.apple.screencapture location "${HOME}/Desktop" + +# etc.. +``` + +### Fixe aplicativos no seu dock + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Vamos fixá-los no seu dock para que fiquem a apenas um clique de distância! + +Para fixar um aplicativo no seu dock, inicie o aplicativo, clique com o botão direito no ícone na barra de tarefas para abrir o menu de contexto e escolha "Opções" e depois "Manter no Dock". + +![Como fixar um aplicativo na barra de tarefas do macOS](images/macos_dock.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack +- Zoom + + +## Configuração concluída! + +Seu computador agora está pronto para o [curso de Desenvolvimento Web Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: + +Aproveite o bootcamp, você vai acertar :rocket: diff --git a/ubuntu.pt.md b/ubuntu.pt.md new file mode 100644 index 00000000..0e9d2595 --- /dev/null +++ b/ubuntu.pt.md @@ -0,0 +1,662 @@ +# Instruções de configuração + +Você encontrará abaixo as instruções para configurar seu computador para o [curso de Desenvolvimento Web da Le Wagon](https://www.lewagon.com/web-development-course/full-time). + +Por favor, **leia com atenção e execute todos os comandos na seguinte ordem**. + +Se você tiver dúvidas, não hesite em pedir ajuda a um professor :raising_hand: + +Você também pode dar uma olhada em [nossas cheatsheets](https://github.com/lewagon/setup/tree/master/docs) para soluções e dicas de problemas comuns :heavy_check_mark: + +Vamos começar :rocket: + +## Zoom + +Para poder interagir quando não estivermos na mesma sala física, usaremos o [Zoom](https://zoom.us/), uma ferramenta de videoconferência. + +:warning: Se você já possui o Zoom instalado, certifique-se de que a versão seja pelo menos **5.6**. + +Acesse [zoom.us/download](https://zoom.us/download). + +Em **Zoom Client** clique no botão **Download**. + +Abra o arquivo que você acabou de baixar para instalar o aplicativo. + +Abra o aplicativo Zoom. + +Se você já possui uma conta Zoom, faça login usando suas credenciais. + +Caso contrário, clique no link **Inscreva-se Gratuitamente**: + +![Cadastre-se gratuitamente no Zoom](images/zoom_sign_up_free.png) + +Você será redirecionado ao site do Zoom para preencher um formulário. + +Quando terminar, volte para o aplicativo Zoom e faça login usando suas credenciais. + +Você deverá então ver uma tela como esta: + +![Zoom tela inicial](images/zoom_home_screen.png) + +Agora você pode fechar o aplicativo Zoom. + +## Conta no GitHub + +Você se inscreveu no GitHub? Caso contrário, [faça isso imediatamente](https://github.com/join). + +:point_right: **[Carregue uma imagem](https://github.com/settings/profile)** e coloque seu nome corretamente em sua conta GitHub. Isso é importante porque usaremos um painel interno com seu avatar. Faça isso **agora**, antes de continuar com este guia. + +![Imagem do GitHub](images/github_picture.png) + +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +Copie (`Ctrl` + `C`) os comandos abaixo e cole-os em seu terminal (`Ctrl` + `Shift` + `v`): + +```bash +wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg +``` + +```bash +sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/ +``` + +```bash +sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list' +``` + +```bash +rm -f packages.microsoft.gpg +``` + +```bash +sudo apt update +``` + +```bash +sudo apt install -y code +``` + +Esses comandos solicitarão sua senha: digite-a. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +### Iniciando a partir do terminal + +Agora vamos iniciar o VS Code no **terminal**: + +```bash +code +``` + +:heavy_check_mark: Se uma janela do VS Code acabou de abrir, você está pronto: +1: + +:x: Caso contrário, por favor **entre em contato com um professor** + +## Extensões do VS Code + +### Instalação + +Vamos instalar algumas extensões úteis no VS Code. + +Copie e cole os seguintes comandos em seu terminal: + +```bash +code --install-extension ms-vscode.sublime-keybindings +code --install-extension emmanuelbeziat.vscode-great-icons +code --install-extension github.github-vscode-theme +code --install-extension MS-vsliveshare.vsliveshare +code --install-extension rebornix.ruby +code --install-extension dbaeumer.vscode-eslint +code --install-extension Rubymaniac.vscode-paste-and-indent +code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +``` + +Aqui está uma lista das extensões que você está instalando: + +- [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) +- [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) +- [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) +- [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) +- [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) + +### Configuração do Live Share + +[Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) é uma extensão do VS Code que permite compartilhar o código em seu editor de texto para depuração e programação em pares: vamos configurá-lo acima! + +Inicie o VS Code em seu terminal digitando `code` e pressionando `Enter`. + +Clique na pequena seta na parte inferior da barra esquerda: point_down: + +![VS Code Live Share](images/vscode_live_share.png) + +- Clique no botão "Compartilhar" e depois em "GitHub (faça login usando a conta GitHub)". +- Um pop-up aparece solicitando que você faça login no GitHub: clique em “Permitir”. +- Você é redirecionado para uma página do GitHub em seu navegador solicitando autorização do Visual Studio Code: clique em "Continuar" e depois em "Autorizar github". +- O VS Code pode exibir pop-ups adicionais: feche-os clicando em "OK". + +É isso, você está pronto para ir! + +## Ferramentas de linha de comando + +### Zsh e Git + +Em vez de usar o `bash` [shell] padrão (https://en.wikipedia.org/wiki/Shell_(computing)), usaremos `zsh`. + +Também usaremos [`git`](https://git-scm.com/), um software de linha de comando usado para controle de versão. + +Vamos instalá-los, juntamente com outras ferramentas úteis: +- Abra um **terminal Ubuntu** +- Copie e cole os seguintes comandos: + +```bash +sudo apt update +``` + +```bash +sudo apt install -y curl git imagemagick jq unzip vim zsh tree +``` + +Esses comandos solicitarão sua senha: digite-a. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +## CLI do GitHub + +CLI é o acrônimo de [Command Line Interface](https://en.wikipedia.org/wiki/Command-line_interface). + +Nesta seção, usaremos [GitHub CLI](https://cli.github.com/) para interagir com o GitHub diretamente do terminal. + +Ele já deve estar instalado no seu computador a partir dos comandos anteriores. + +Primeiro, para **fazer login**, copie e cole o seguinte comando em seu terminal: + +:warning: **NÃO edite o `email`** + +```bash +gh auth login -s 'user:email' -w +``` + +gh fará algumas perguntas: + +`What is your preferred protocol for Git operations?` With the arrows, choose `SSH` and press `Enter`. SSH é um protocolo para fazer login usando chaves SSH em vez do conhecido par nome de usuário/senha. + +`Generate a new SSH key to add to your GitHub account?` Pressione `Enter` para pedir ao gh gerar as chaves SSH para você. + +Se você já possui chaves SSH, verá `Upload your SSH public key to your GitHub account?` Com as setas, selecione o caminho do arquivo de sua chave pública e pressione `Enter`. + +`Enter a passphrase for your new SSH key (Optional)`. Digite algo que você deseja e que você lembrará. É uma senha para proteger sua chave privada armazenada no disco rígido. Em seguida, pressione `Enter`. + +`Title for your SSH key`. Você pode deixá-lo no "GitHub CLI" proposto, pressione `Enter`. + +Você obterá então a seguinte saída: + +```bash +! First copy your one-time code: 0EF9-D015 +- Press Enter to open github.com in your browser... +``` + +Selecione e copie o código (`0EF9-D015` no exemplo) e pressione `Enter`. + +Seu navegador será aberto e solicitará que você autorize o GitHub CLI a usar sua conta GitHub. Aceite e espere um pouco. + +Volte ao terminal, pressione `Enter` novamente e pronto. + +Para verificar se você está conectado corretamente, digite: + +```bash +gh auth status +``` + +:heavy_check_mark: Se você estiver `Logged in to github.com as `, então tudo bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +## Dotfiles (configuração padrão) + +Os hackers adoram refinar e aprimorar sua estrutura e ferramentas. + +Começaremos com uma ótima configuração padrão fornecida pelo Le Wagon: [`lewagon/dotfiles`](https://github.com/lewagon/dotfiles). + +Como sua configuração é pessoal, você precisa de seu próprio repositório para armazená-la. Então você irá fazer um **fork** do repositório Le Wagon. + +Bifurcar significa que você criará um novo repositório em sua própria conta GitHub `$GITHUB_USERNAME/dotfiles`, idêntico ao original do Le Wagon que você poderá modificar à vontade. + +Abra seu terminal e defina uma variável para seu nome de usuário GitHub: + +```bash +export GITHUB_USERNAME=`gh api user | jq -r '.login'` +``` + +```bash +echo $GITHUB_USERNAME +``` + +:heavy_check_mark: Você deverá ver seu nome de usuário do GitHub impresso. + +:x: Se não, **pare aqui** e peça ajuda. Pode haver um problema com a etapa anterior (`gh auth`). + +:warning: Por favor, note que esta variável só é definida para o tempo em que seu terminal está aberto. Se você fechá-lo antes ou durante as próximas etapas, será necessário configurá-lo novamente com as duas etapas acima! + + +É hora de fazer um fork do repositório e cloná-lo em seu computador: + +```bash +mkdir -p ~/code/$GITHUB_USERNAME && cd $_ +``` + +```bash +gh repo fork lewagon/dotfiles --clone +``` + +### Instalador do Dotfiles + +Execute o instalador `dotfiles`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles +``` + +```bash +zsh install.sh +``` + +Verifique os e-mails registrados em sua conta GitHub. Você precisará escolher um na próxima etapa: + +```bash +gh api user/emails | jq -r '.[].email' +``` + +:heavy_check_mark: Se você vir a lista de seus e-mails registrados, você pode prosseguir :+1: + +:x: Caso contrário, [reautentique-se no GitHub](https://github.com/lewagon/setup/blob/master/macos.md#github-cli) antes de executar este comando :point_up: novamente. + +### instalador git + +Execute o instalador `git`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh +``` + +:point_up: Isso **solicitará** seu nome (`Nome Sobrenome`) e seu e-mail. + +:warning: Você **precisa** colocar um dos e-mails listados acima graças ao comando anterior `gh api ...`. Se você não fizer isso, Kitt não conseguirá acompanhar seu progresso. + +Agora **reinicie** seu terminal executando: + +```bash +exec zsh +``` + +## Desativar prompt de senha SSH + +Você não quer que sua senha seja solicitada sempre que se comunicar com um repositório distante. Então, você precisa adicionar o plugin `ssh-agent` ao `oh my zsh`: + +Primeiro, abra o arquivo `.zshrc`: + +```bash +code ~/.zshrc +``` + +Então: +- Identifique a linha que começa com `plugins=` +- Adicione `ssh-agent` no final da lista de plugins + +:heavy_check_mark: Salve o arquivo `.zshrc` com `Ctrl` + `S` e feche seu editor de texto. + +## rbenv + +Vamos instalar o [`rbenv`](https://github.com/sstephenson/rbenv), um software para instalar e gerenciar ambientes `ruby`. + +Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter: + +```bash +rvm implode && sudo rm -rf ~/.rvm +# Se você obteve "zsh: command not found: rvm", continue. Isso significa que `rvm` não está +# no seu computador, e é isso que queremos! + +sudo rm -rf $HOME/.rbenv /usr/local/rbenv /opt/rbenv /usr/local/opt/rbenv +``` + +:warning: Este comando pode solicitar sua senha. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +Então no Terminal, rode + +```bash +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +``` + +```bash +git clone https://github.com/rbenv/rbenv.git ~/.rbenv +``` + +```bash +git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build +``` + +```bash +exec zsh +``` + +## Ruby + +### Instalação + +Agora, você está pronto para instalar a versão mais recente do [ruby](https://www.ruby-lang.org/en/) e defini-la como a versão padrão. + +Execute este comando, **demorará um pouco (5 a 10 minutos)** + +```bash +rbenv install 3.1.2 +``` + +Assim que a instalação do Ruby estiver concluída, execute este comando para informar ao sistema +para usar a versão 3.1.2 por padrão. + +```bash +rbenv global 3.1.2 +``` + +**Reinicialize** seu terminal e verifique sua versão do Ruby: + +```bash +exec zsh +``` + +Então rode: + +```bash +ruby -v +``` + +:heavy_check_mark: Se você vir algo começando com `ruby 3.1.2p` então você pode prosseguir :+1: + +:x: Se não, **pergunte a um professor** + +### Instalando algumas gems + +
+ Se você estiver na China 🇨🇳 clique aqui + + :warning: Se você estiver na China, você deve atualizar a forma como instalaremos as gems com os seguintes comandos. + +```bash +# Somente China! +gem sources --remove https://rubygems.org/ +gem sources -a https://gems.ruby-china.com/ +gem sources -l +#***FONTES ATUAIS*** +# https://gems.ruby-china.com/ +# Ruby-china.com deve estar na lista agora +``` +
+ +**Todos, na China ou não**, continuem aqui para instalar gems. + +No mundo Ruby, chamamos bibliotecas externas de `gems`: são pedaços de código Ruby que você pode baixar e executar em seu computador. Vamos instalar alguns! + +No seu terminal, copie e cole o seguinte comando: + +```bash +gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +``` + +:heavy_check_mark: Se você tiver `xx gems installed`, então tudo bem :+1: + +:x: Se você encontrar o seguinte erro: + +```bash +ERROR: While executing gem ... (TypeError) +incompatible marshal file format (can't be read) +format version 4.8 required; 60.33 given +``` + +Execute o seguinte comando: +```bash +rm -rf ~/.gemrc +``` + +Execute novamente o comando para instalar as gems. + +:warning: **NUNCA** instale uma gem com `sudo gem install`! Mesmo se você encontrar uma resposta do Stackoverflow (ou o terminal) solicitando que você faça isso. + +## Node.js + +[Node.js](https://nodejs.org/en/) é um JavaScript runtime para executar código JavaScript no terminal. Vamos instalá-lo com [nvm](https://github.com/nvm-sh/nvm), um gerenciador de versões para Node.js. + +Em um terminal, execute os seguintes comandos: + +```bash +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +nvm -v +``` + +Você deverá ver uma versão. Se não, pergunte a um professor. + +Agora vamos instalar o Node: + +```bash +nvm install 16.15.1 +``` + +Quando a instalação terminar, execute: + +```bash +node -v +``` + +Se você vir `v16.15.1`, a instalação foi bem-sucedida: heavy_check_mark: Você pode então executar: + +```bash +nvm cache clear +``` + +:x: Caso contrário, **entre em contato com um professor** + +## Yarn + +[`yarn`](https://yarnpkg.com/) é um gerenciador de pacotes para instalar bibliotecas JavaScript. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +npm install --global yarn +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +yarn -v +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** + +## SQLite + +Em algumas semanas falaremos sobre bancos de dados e SQL. [SQLite](https://sqlite.org/index.html) é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +sudo apt-get install sqlite3 libsqlite3-dev +``` + +Em seguida, execute o seguinte comando: + +```bash +sqlite3 -version +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** + +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential +``` + +```bash +sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;" +``` + +## Checagem + +Vamos verificar se você instalou tudo com sucesso. + +No seu terminal, execute o seguinte comando: + +```bash +exec zsh +``` + +Então rode: + +```bash +curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb +``` + +:heavy_check_mark: Se você receber uma mensagem verde `Incrível! Seu computador agora está pronto!`, então você está bem: +1: + +:x: Caso contrário, **entre em contato com um professor**. + +## Kitt + +:warning: Se você recebeu um e-mail do Le Wagon convidando você a se inscrever no Kitt (nossa plataforma de aprendizagem), você pode pular esta etapa com segurança. Em vez disso, siga as instruções no e-mail que você recebeu, caso ainda não tenha feito isso. + +Se não tiver certeza sobre o que fazer, siga [este link](https://kitt.lewagon.com/). Se você já estiver logado, pode pular esta seção com segurança. Se você não estiver logado, clique em `Enter Kitt as a Student`. Se você conseguir fazer login, poderá pular esta etapa com segurança. Caso contrário, pergunte a um professor se você deveria ter recebido um e-mail ou siga as instruções abaixo. + +Registre-se como alumni da Wagon acessando [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Selecione seu lote, faça login no GitHub e insira todas as suas informações. + +Seu professor irá então validar se você realmente faz parte do batch. Você pode pedir que eles façam isso assim que preencher o formulário de registro. + +Assim que o professor aprovar seu perfil, acesse sua caixa de entrada de e-mail. Você deve ter 2 e-mails: + +- Um do Slack, convidando você para a comunidade Le Wagon Alumni do Slack (onde você conversará com seus amigos e todos os ex-alunos anteriores). Clique em **Inscreva-se** e preencha os dados. +- Um do GitHub, convidando você para a equipe `lewagon`. **Aceite** caso contrário você não conseguirá acessar os slides da aula. + +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://get.slack.help/hc/en-us/articles/212924728-Slack-for-Linux-beta-) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. + +### Configurações + +Inicie o aplicativo e faça login na organização `lewagon-alumni`. + +Certifique-se de **fazer upload de uma foto de perfil** :point_down: + +![Como fazer upload de uma foto de perfil no Slack](images/slack_profile_picture.gif) + +A ideia é que você tenha o Slack aberto o dia todo, para que você possa compartilhar links úteis/pedir ajuda/decidir onde ir almoçar/etc. + +Para garantir que tudo está funcionando bem nas videochamadas, vamos testar sua câmera e microfone: +- Abra o aplicativo Slack +- Clique na foto do seu perfil no canto superior direito. +- Selecione `Preferências` no menu. +- Clique em `Áudio e vídeo` na coluna do lado esquerdo. +- Abaixo de `Solução de problemas`, clique em `Executar um teste de áudio, vídeo e compartilhamento de tela`. O teste será aberto em uma nova janela. +- Verifique se seus dispositivos preferidos de alto-falante, microfone e câmera aparecem nos menus suspensos e clique em `Iniciar teste`. + +![Verifique o microfone e a webcam com o Slack](images/slack_call_test.png) + +:heavy_check_mark: Quando o teste terminar, você deverá ver mensagens verdes de "Sucesso" pelo menos para seu microfone e câmera. :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +Você também pode instalar o aplicativo Slack no seu telefone e entrar em `lewagon-alumni`! + +##Configurações do Ubuntu + +### Instale o codec de vídeo H264 + +Na nossa plataforma pedagógica (Kitt, você vai descobrir em breve!), temos alguns vídeos. Por padrão, o Firefox no Linux não pode reproduzi-los porque eles usam um codec não suportado (H264). Para que esses vídeos funcionem para você, você precisa executar o seguinte: + +```bash +sudo apt instalar libavcodec-extra -y +``` + +### Instale ferramentas de terminal úteis + +`tree` é uma boa ferramenta para visualizar uma árvore de diretórios dentro do terminal: + +`ncdu` é um utilitário de disco de interface baseado em texto. + +`htop` é um visualizador de processos interativo. + +`tig` é uma interface em modo texto para `git`. + +```bash +sudo apt install tree ncdu htop tig +``` + +### Ubuntu inotify + +O Ubuntu está sempre rastreando alterações em suas pastas e para isso usa o inotify. +Por padrão, o limite do Ubuntu é definido para 8.192 arquivos monitorados. + +Como a programação envolve muitos arquivos, precisamos aumentar esse limite. +Em seu terminal, execute: + +```bash +echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p +``` + +### Fixe aplicativos no seu dock + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Então, vamos fixá-los no seu dock para que fiquem a apenas um clique de distância! + +Para fixar um aplicativo no seu dock, inicie o aplicativo, clique com o botão direito no ícone do dock para abrir o menu de contexto e escolha "Adicionar aos Favoritos". + +![Como fixar um aplicativo no dock no Ubuntu](images/ubuntu_dock.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack +- Zoom + + +## Configuração concluída! + +Seu computador agora está pronto para o [curso de Desenvolvimento Web Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: + +Aproveite o bootcamp, você vai acertar :rocket: diff --git a/windows.pt.md b/windows.pt.md new file mode 100644 index 00000000..6f5aaa38 --- /dev/null +++ b/windows.pt.md @@ -0,0 +1,1247 @@ +# Instruções de configuração + +Você encontrará abaixo as instruções para configurar seu computador para o [curso de Desenvolvimento Web da Le Wagon](https://www.lewagon.com/web-development-course/full-time). + +Por favor, **leia com atenção e execute todos os comandos na seguinte ordem**. + +Se você tiver dúvidas, não hesite em pedir ajuda a um professor :raising_hand: + +Você também pode dar uma olhada em [nossas cheatsheets](https://github.com/lewagon/setup/tree/master/docs) para soluções e dicas de problemas comuns :heavy_check_mark: + +Vamos começar :rocket: + +## Zoom + +Para poder interagir quando não estivermos na mesma sala física, usaremos o [Zoom](https://zoom.us/), uma ferramenta de videoconferência. + +:warning: Se você já possui o Zoom instalado, certifique-se de que a versão seja pelo menos **5.6**. + +Acesse [zoom.us/download](https://zoom.us/download). + +Em **Zoom Client** clique no botão **Download**. + +Abra o arquivo que você acabou de baixar para instalar o aplicativo. + +Abra o aplicativo Zoom. + +Se você já possui uma conta Zoom, faça login usando suas credenciais. + +Caso contrário, clique no link **Inscreva-se Gratuitamente**: + +![Cadastre-se gratuitamente no Zoom](images/zoom_sign_up_free.png) + +Você será redirecionado ao site do Zoom para preencher um formulário. + +Quando terminar, volte para o aplicativo Zoom e faça login usando suas credenciais. + +Você deverá então ver uma tela como esta: + +![Zoom tela inicial](images/zoom_home_screen.png) + +Agora você pode fechar o aplicativo Zoom. + +## Conta no GitHub + +Você se inscreveu no GitHub? Caso contrário, [faça isso imediatamente](https://github.com/join). + +:point_right: **[Carregue uma imagem](https://github.com/settings/profile)** e coloque seu nome corretamente em sua conta GitHub. Isso é importante porque usaremos um painel interno com seu avatar. Faça isso **agora**, antes de continuar com este guia. + +![Imagem do GitHub](images/github_picture.png) + +## Versão do Windows + +Antes de começarmos, precisamos verificar se a versão do Windows instalada no seu computador é compatível com estas instruções de configuração. + +### Windows 10 ou Windows 11 + +Para poder configurar seu computador, você precisa ter o **Windows 10 ou Windows 11** instalado. + +Para verificar sua versão do Windows: +- Pressione `Windows` + `R` +- Digite `winver` +- Pressione `Enter` + +:heavy_check_mark: Se as primeiras palavras desta janela forem **Windows 10 ou Windows 11** você está pronto para prosseguir :+1: + +:x: Caso contrário, você não poderá prosseguir com esta configuração. Você precisa atualizar para o Windows 10 primeiro: point_down: + +
+ Atualizar para o Windows 10 + + - Baixe o Windows 10 da [Microsoft](https://www.microsoft.com/software-download/windows10ISO) + - Instale-o. Deve demorar cerca de uma hora, mas isso depende do seu computador. + - Quando a instalação terminar, execute os comandos acima :point_up: para verificar se você agora tem o **Windows 10**. +
+ +:information_source: [A atualização do Windows 11 está sendo lançada agora](https://www.microsoft.com/en-us/windows/get-windows-11), o que significa que ela pode ou não estar disponível para o seu computador ainda . + +:warning: **Se você tiver o Windows 10 instalado, não será necessário atualizar para o Windows 11 para prosseguir com esta configuração**. + +### Ultimas atualizações + +Quando tiver certeza de que está usando o Windows 10 ou 11, você precisará instalar todas as atualizações mais recentes. + +Abra a atualização do Windows: +- Pressione `Windows` + `R` +- Digite `ms-settings:windowsupdate` +- Pressione `Enter` +- Clique em `Verificar atualizações` + +:heavy_check_mark: Se você vir uma marca de seleção verde e a mensagem "Você está atualizado", você está pronto para prosseguir :+1: + +:warning: Se você tiver um ponto de exclamação vermelho e a mensagem "Atualização disponível", instale-os e repita o processo até que apareça que você está atualizado :loop: + +:x: Se você receber uma mensagem de erro sobre o Windows não conseguir aplicar atualizações, **entre em contato com um professor**. + +
+ Ative o Windows Update Service para corrigir atualizações + + Alguns antivírus e softwares desativam o serviço de atualização de que precisamos, resultando no erro que você vê. Vamos consertar isso! + - Pressione `Windows` + `R` + - Digite `services.msc` + - Pressione `Enter` + - Clique duas vezes em `Serviço de atualização do Windows` + - Defina sua `Inicialização` para `Automático` + - Clique em `Iniciar` + - Clique em `Ok` + Então vamos tentar as atualizações novamente! +
+ +### Versão mínima + +Algumas das ferramentas que precisamos instalar foram lançadas com a versão `1903` **ou superior** do Windows 10, então precisamos ter certeza de que você tem pelo menos esta. + +- Pressione `Windows` + `R` +- Digite `winver` +- Pressione `Enter` + +Verifique o **Número da versão**: + +:heavy_check_mark: Se disser pelo menos `1903`, você está pronto :+1: + +:x: Se estiver abaixo de `1903`, por favor **entre em contato com um professor**. + +## Virtualização + +Precisamos garantir que as opções de virtualização estejam habilitadas no BIOS do seu computador. + +Para muitos computadores, este já é o caso. Vamos checar: +- Pressione `Windows` + `R` +- Digite `taskmgr` +- Pressione `Enter` +- Clique na aba `Desempenho` +- Clique em `CPU` + +![Gerenciador de tarefas do Windows](images/windows_task_manager.png) + +:heavy_check_mark: Se você vir "Virtualização: Ativada", está pronto: +1: + +:x: Se a linha estiver faltando ou se a virtualização estiver desabilitada, por favor **entre em contato com um professor antes de tentar ativar a Virtualização** + +
+ Ativar virtualização + + Precisamos acessar o BIOS/UEFI do computador para ativá-lo. + - Pressione `Windows + R` + - Digite `shutdown.exe /r /o /t 1` + - Pressione `Enter` + - Aguarde o computador desligar + - Clique em `Solucionar problemas` + - Clique em `Opções avançadas` + - Clique em `Configurações de firmware UEFI` + - Clique em `Reiniciar` + + Você precisa ativar a opção de virtualização para o seu processador aqui: + - Na maioria das vezes, nas configurações avançadas, nas configurações da CPU ou nas configurações do Northbridge + - A opção pode ter um nome diferente de acordo com o seu computador: + - Intel: `Intel VT-x`, `Tecnologia de virtualização Intel`, `Extensões de virtualização`, `Vanderpool`... + - AMD: `Modo SVM` ou `AMD-V` + - Salve as alterações após a ativação e reinicie o computador através da opção apropriada +
+ +## Subsistema Windows para Linux (WSL) + +WSL é o ambiente de desenvolvimento que usamos para executar o Ubuntu. Você pode aprender mais sobre WSL [aqui](https://docs.microsoft.com/en-us/windows/wsl/faq). + +:information_source: As instruções a seguir dependem da sua versão do Windows. Por favor, execute apenas as instruções correspondentes à sua versão :point_down: + +### Windows 11 + +Se você estiver executando o Windows 11, instalaremos o WSL 2 e o Ubuntu em um comando através do Terminal do Windows. + +:warning: Nas instruções a seguir, esteja ciente do pressionamento de tecla `Ctrl` + `Shift` + `Enter` para executar o **Terminal Windows** com privilégios de administrador em vez de apenas clicar em `Ok` ou pressionar `Enter` . + +- Pressione `Windows` + `R` +- Digite `wt` +- Pressione **`Ctrl` + `Shift` + `Enter`** + +:warning: Você pode ter que aceitar a confirmação do UAC sobre a elevação de privilégio. + +Uma janela de terminal azul aparecerá: +- Copie o seguinte comando (`Ctrl` + `C`) +- Cole-o na janela do terminal (`Ctrl` + `V` ou clicando com o botão direito na janela) +- Execute-o pressionando `Enter` + +```PowerShell +wsl --install +``` + +:heavy_check_mark: Se o comando foi executado sem nenhum erro, reinicie o computador e continue abaixo:+1: + +:x: Se você encontrar uma mensagem de erro (ou se vir algum texto em vermelho na janela), por favor **entre em contato com um professor** + +### Windows 10 + +#### Instale o WSL 1 + +Se você estiver executando o Windows 10, primeiro instalaremos o WSL 1 por meio do Terminal PowerShell. + +:warning: Nas instruções a seguir, esteja ciente do pressionamento de tecla `Ctrl` + `Shift` + `Enter` para executar o **Windows PowerShell** com privilégios de administrador em vez de apenas clicar em `Ok` ou pressionar `Enter` . + +- Pressione `Windows` + `R` +- Digite `powershell` +- Pressione **`Ctrl` + `Shift` + `Enter`** + +:warning: Você pode ter que aceitar a confirmação do UAC sobre a elevação de privilégio. + +Uma janela de terminal azul aparecerá: +- Copie os seguintes comandos um por um (`Ctrl` + `C`) +- Cole-os na janela do PowerShell (`Ctrl` + `V` ou clicando com o botão direito na janela) +- Execute-os pressionando `Enter` + +```powershell +Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux +``` + +```powershell +dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart +``` + +```powershell +dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart +``` + +:heavy_check_mark: Se todos os três comandos foram executados sem nenhum erro, reinicie o computador e continue abaixo:+1: + +:x: Se você encontrar uma mensagem de erro (ou se vir algum texto em vermelho na janela), por favor **entre em contato com um professor** + +#### Atualizar para WSL 2 + +Se você estiver executando o Windows 10, atualizaremos o WSL para a versão 2. + +Assim que o computador for reiniciado, precisamos baixar o instalador WSL2. + +- Vá para a [página de download](https://aka.ms/wsl2kernel) +- Baixe o "pacote de atualização do kernel WSL2 Linux" +- Abra o arquivo que você acabou de baixar +- Clique em `Avançar` +- Clique em `Concluir` + +![Atualize WSL da versão 1 para 2](images/windows_update_wsl.png) + +:heavy_check_mark: Se não encontrou nenhuma mensagem de erro, você está pronto: +1: + +:x: Se você encontrar o erro "Esta atualização se aplica apenas a máquinas com o subsistema Windows para Linux", **clique com o botão direito** no programa e selecione `uninstall`; você poderá instalá-lo normalmente desta vez. + +#### Torne o WSL 2 o Subsistema Windows para Linux padrão + +Se você estiver executando o Windows 10, definiremos a versão padrão do WSL como 2. + +Agora que o WSL 2 está instalado, vamos torná-lo a versão padrão: +- Pressione `Windows` + `R` +- Digite `cmd` +- Pressione `Enter` + +Na janela que aparece, digite: + +```bash +wsl --set-default-version 2 +``` + +:heavy_check_mark: Se você vir "A operação foi concluída com sucesso", você pode fechar este terminal e continuar seguindo as instruções abaixo:+1: + +:x: Se a mensagem que você receber for sobre Virtualização, por favor **entre em contato com um professor** + +
+ Ativar recurso Windows da Plataforma de Máquina Virtual + + Siga as etapas descritas [aqui](https://www.configserverfirewall.com/windows-10/please-enable-the-virtual-machine-platform-windows-feature-and-ensure-virtualization-is-enabled-in- the-bios/#:~:text=To%20enable%20WSL%202,%20Open,Windows%20feature%20on%20or%20off.&text=Garanta%20que%20the%20Virtual%20Machine,Windows%20will%20enable%20WSL %202) até você ativar a Plataforma de Máquina Virtual e o Subsistema Windows para Linux +
+ +
+ Ativar recurso Hyper-V do Windows + + Siga as etapas descritas [aqui](https://winaero.com/enable-use-hyper-v-windows-10/) até ativar o grupo Hyper-V + + :information_source: Se você estiver executando o Windows 10 **Home edition**, o recurso Hyper-V não estará disponível para o seu sistema operacional. Não bloqueia e você ainda pode continuar seguindo as instruções abaixo: ok_hand: +
+ +## Ubuntu + +### Instalação + +:information_source: As instruções a seguir dependem da sua versão do Windows. Por favor, execute apenas as instruções correspondentes à sua versão :point_down: + +#### Windows 11 + +Se você estiver executando o Windows 11, após reiniciar o computador, você deverá ver uma janela de terminal informando que o WSL está retomando o processo de instalação do Ubuntu. Quando terminar, o Ubuntu será iniciado. + +#### Windows 10 + +Se você estiver executando o Windows 10, vamos instalar o Ubuntu através da Microsoft Store: + +- Clique em `Iniciar` +- Digite `Microsoft Store` +- Clique em `Microsoft Store` na lista +- Procure por `Ubuntu` na barra de pesquisa +- **Selecione a versão sem nenhum número, simplesmente "Ubuntu"** +- Clique em `Obter` + +:warning: Não instale **Ubuntu 18.04 LTS** nem **Ubuntu 20.04**! + +
+ Desinstale versões erradas do Ubuntu + + Para desinstalar uma versão errada do Ubuntu, basta ir até a Lista de Programas Instalados do Windows 10: + - Pressione `Windows` + `R` + - Digite `ms-settings:appsfeatures` + - Pressione `Enter` + + Encontre o software para desinstalar e clique no botão desinstalar. +
+ +Assim que a instalação for concluída, o botão `Get` se torna um botão `Open`: clique nele. + +### Primeira vez + +Na primeira vez que abrir o programa, serão solicitadas algumas informações: +- Escolha um nome de usuário**: + - uma palavra + - minúsculas + - sem caracteres especiais + - por exemplo: `lewagon` ou seu `nome` +- Escolha uma senha** +- Confirme sua senha + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +Você pode fechar a janela do Ubuntu agora que ele está instalado no seu computador. + +### Verifique a versão WSL do Ubuntu + +- Pressione `Windows` + `R` +- Digite `cmd` +- Pressione `Enter` + +Digite o seguinte comando: + +```bash +wsl -l -v +``` + +:heavy_check_mark: Se a versão do Ubuntu WSL for 2, você está pronto: +1: + +:x: Se a versão do Ubuntu WSL for 1, precisaremos convertê-lo para a versão 2. + +
+ Converter Ubuntu WSL V1 em V2 + + Na janela do prompt de comando, digite: + + ```bash + wsl --set-version Ubuntu 2 + ``` + + :heavy_check_mark: Após alguns segundos, você deverá receber a seguinte mensagem: `A conversão foi concluída`. + + :x: Se não funcionar, precisamos ter certeza de que os arquivos do Ubuntu não estão compactados. + + +
+ Verificar arquivos descompactados + + - Pressione `Windows` + `R` + - Digite `%localappdata%\Packages` + - Pressione `Enter` + - Abra a pasta chamada `CanonicalGroupLimited.UbuntuonWindows...` + - Clique com o botão direito na pasta `LocalState` + - Clique em `Propriedades` + - Clique em `Avançado` + - Certifique-se de que a opção `Compactar conteúdo` **não** esteja marcada e clique em `Ok`. + + Aplique as alterações apenas nesta pasta e tente converter a versão WSL do Ubuntu novamente. + + :x: Se a conversão ainda não funcionar, por favor **entre em contato com um professor**. +
+ +### Verifique a localidade + +A localidade é um mecanismo que permite personalizar programas de acordo com seu idioma e país. + +Vamos verificar se a localidade padrão está definida como inglês, digite isto no terminal do Ubuntu: + +```bash +locale +``` + +Se a saída não contiver `LANG=en_US.UTF-8`, execute o seguinte comando em um terminal Ubuntu para instalar a localidade em inglês: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Agora você pode fechar esta janela do terminal. + +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +- Vá para a [página de download do Visual Studio Code](https://code.visualstudio.com/download). +- Clique no botão "Windows" +- Abra o arquivo que você acabou de baixar. +- Instale-o com algumas opções: + +![Opções de instalação do VS Code](images/windows_vscode_installation.png) + +Quando a instalação for concluída, inicie o VS Code. + +### Conectando o VS Code ao Ubuntu + +Para fazer o VS Code interagir corretamente com o Ubuntu, vamos instalar a extensão [Remote - WSL](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl) VS Code. + +Abra seu **terminal Ubuntu**. + +Copie e cole os seguintes comandos no terminal: + +```bash +code --install-extension ms-vscode-remote.remote-wsl +``` + +Em seguida, abra o VS Code em seu terminal: + +```bash +code . +``` + +:heavy_check_mark: Se você vir `WSL: Ubuntu` no canto inferior esquerdo da janela do VS Code, você está pronto para prosseguir :+1: + +![WSL Ubuntu remoto](images/windows_remote_wsl.png) + +:x: Caso contrário, por favor **entre em contato com um professor** + +## Terminal do Windows + +### Instalação + +:information_source: As instruções a seguir dependem da sua versão do Windows. + +Se você estiver executando o Windows 11, o Terminal do Windows já está instalado e você pode prosseguir para a próxima seção: point_down: + +Se você estiver executando o Windows 10, vamos instalar o Windows Terminal, um terminal realmente moderno: + +- Clique em `Iniciar` +- Digite `Microsoft Store` +- Clique em `Microsoft Store` na lista +- Procure por `Windows Terminal` na barra de pesquisa +- **Selecione Terminal do Windows"** +- Clique em `Instalar` + +:warning: NÃO instale o **Windows Terminal Preview**, apenas o **Windows Terminal**! + +
+ Desinstale a versão errada do Terminal do Windows + + Para desinstalar uma versão errada do Terminal Windows, basta ir até a Lista de Programas Instalados do Windows 10: + + - Pressione `Windows` + `R` + - Digite `ms-settings:appsfeatures` + - Pressione `Enter` + + Encontre o software para desinstalar e clique no botão desinstalar. +
+ +Assim que a instalação for concluída, o botão `Instalar` se torna um botão `Iniciar`: clique nele. + +### Ubuntu como terminal padrão + +Vamos tornar o Ubuntu o terminal padrão do seu aplicativo Windows Terminal. + +Pressione `Ctrl` + `,` + +Deve abrir as configurações do terminal: + +![Configurações do Terminal do Windows](images/windows_terminal_settings.png) + +- Altere o perfil padrão para "Ubuntu" +- Clique em "Salvar" +- Clique em "Abrir arquivo JSON" + +Você pode ver um círculo laranja em vez de um pinguim como logotipo do Ubuntu. + +Temos um círculo em vermelho na parte que você irá alterar: + +![Arquivo de configurações JSON do Terminal do Windows](images/windows_terminal_settings_json.png) + +Primeiro, vamos pedir ao Ubuntu para iniciar diretamente dentro do diretório inicial do Ubuntu, em vez do diretório do Windows: +- Localize a entrada com `"name": "Ubuntu",` e `"hidden": false,` +- Adicione a seguinte linha depois dela: + +```bash +"commandline": "wsl.exe ~", +``` + +:warning: Não esqueça a vírgula no final da linha! + +Então, vamos desabilitar o aviso para comandos de copiar e colar entre o Windows e o Ubuntu: +- Localize a linha `"defaultProfile": "{2c4de342-...}"` +- Adicione a seguinte linha depois dela: + +```bash +"multiLinePasteWarning": false, +``` + +:warning: Não esqueça a vírgula no final da linha! + +Você pode salvar essas alterações pressionando `Ctrl` + `S` + +:heavy_check_mark: Seu **Terminal Windows** agora está configurado :+1: + +Este terminal possui abas: você pode optar por abrir uma nova aba do terminal clicando em **+** ao lado da atual. + +**De agora em diante, toda vez que nos referirmos ao terminal ou ao console será este.** NÃO utilize mais nenhum outro terminal. + +## Extensões do VS Code + +### Instalação + +Vamos instalar algumas extensões úteis no VS Code. + +Copie e cole os seguintes comandos em seu terminal: + +```bash +code --install-extension ms-vscode.sublime-keybindings +code --install-extension emmanuelbeziat.vscode-great-icons +code --install-extension github.github-vscode-theme +code --install-extension MS-vsliveshare.vsliveshare +code --install-extension rebornix.ruby +code --install-extension dbaeumer.vscode-eslint +code --install-extension Rubymaniac.vscode-paste-and-indent +code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +``` + +Aqui está uma lista das extensões que você está instalando: + +- [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) +- [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) +- [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) +- [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) +- [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) + +### Configuração do Live Share + +[Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) é uma extensão do VS Code que permite compartilhar o código em seu editor de texto para depuração e programação em pares: vamos configurá-lo acima! + +Inicie o VS Code em seu terminal digitando `code` e pressionando `Enter`. + +Clique na pequena seta na parte inferior da barra esquerda: point_down: + +![VS Code Live Share](images/vscode_live_share.png) + +- Clique no botão "Compartilhar" e depois em "GitHub (faça login usando a conta GitHub)". +- Um pop-up aparece solicitando que você faça login no GitHub: clique em “Permitir”. +- Você é redirecionado para uma página do GitHub em seu navegador solicitando autorização do Visual Studio Code: clique em "Continuar" e depois em "Autorizar github". +- O VS Code pode exibir pop-ups adicionais: feche-os clicando em "OK". + +É isso, você está pronto para ir! + +## Ferramentas de linha de comando + +### Zsh e Git + +Em vez de usar o `bash` [shell] padrão (https://en.wikipedia.org/wiki/Shell_(computing)), usaremos `zsh`. + +Também usaremos [`git`](https://git-scm.com/), um software de linha de comando usado para controle de versão. + +Vamos instalá-los, juntamente com outras ferramentas úteis: +- Abra um **terminal Ubuntu** +- Copie e cole os seguintes comandos: + +```bash +sudo apt update +``` + +```bash +sudo apt install -y curl git imagemagick jq unzip vim zsh tree +``` + +Esses comandos solicitarão sua senha: digite-a. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +### Instalação da CLI do GitHub + +Vamos agora instalar a [CLI oficial do GitHub](https://cli.github.com) (interface de linha de comando). É um software usado para interagir com sua conta GitHub através da linha de comando. + +Em seu terminal, copie e cole os seguintes comandos e digite sua senha, se solicitado: + +```bash +sudo apt remove -y gitsome # gh pode entrar em conflito com o gitsome se já estiver instalado +curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg +``` + +```bash +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null +``` + +```bash +sudo apt update +``` + +```bash +sudo apt install -y gh +``` + +Para verificar se `gh` foi instalado com sucesso em sua máquina, você pode executar: + +```bash +gh --version +``` + +:heavy_check_mark: Se você vir `gh versão X.Y.Z (AAAA-MM-DD)`, está pronto para prosseguir :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** + +## Oh-My-Zsh + +Vamos instalar o plugin `zsh` [Oh My Zsh](https://ohmyz.sh/). + +Em um terminal execute o seguinte comando: + +```bash +sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" +``` + +Se for perguntado "Do you want to change your default shell to zsh?", pressione `Y` + +No final seu terminal deverá ficar assim: + +![Terminal Ubuntu com OhMyZsh](images/oh_my_zsh.png) + +:heavy_check_mark: Se isso acontecer, você pode continuar :+1: + +:x: Caso contrário, por favor ** peça um professor ** + +## Vinculando seu navegador padrão ao Ubuntu + +Para ter certeza de que você pode interagir com seu navegador instalado no Windows a partir do terminal Ubuntu, precisamos defini-lo como navegador padrão. + +:warning: Você precisa executar pelo menos um dos seguintes comandos abaixo: + +
+ Google Chrome como navegador padrão + + Execute o comando: + + ```bash + ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exe + ``` + + Você recebeu um erro como `ls: não é possível acessar...`? + +
+ Sim, ocorreu um erro + +Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc + ``` +
+ +
+ Não, estava tudo bem + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc + ``` +
+ +--- + +
+ +
+ Mozilla Firefox como seu navegador padrão + + Execute o comando: + + ```bash + ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exe + ``` + + Você recebeu um erro como `ls: não é possível acessar...`? + +
+ Sim, ocorreu um erro + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc + ``` + +
+ +
+ Não, estava tudo bem + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc + ``` +
+ +--- + +
+ +
+ Microsoft Edge como navegador padrão + + Execute os comandos: + + ```bash + echo "export BROWSER='\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"'" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc + ``` + +--- + +
+ +Reinicie seu terminal. + +Em seguida, certifique-se de que o seguinte comando retorne "Browser Defined 👌": + +```bash +[ -z "$BROWSER" ] && echo "ERROR: please define a BROWSER environment variable ⚠️" || echo "Browser defined 👌" +``` + +Se isso não acontecer, + +:heavy_check_mark: Se você recebeu esta mensagem, pode continuar :+1: + +:x: Caso contrário, escolha um navegador na lista acima e execute o comando correspondente. Então não se esqueça de redefinir seu terminal: + +```bash +exec zsh +``` + +Não hesite em **entrar em contato com um professor**. + +## CLI do GitHub + +CLI é o acrônimo de [Command Line Interface](https://en.wikipedia.org/wiki/Command-line_interface). + +Nesta seção, usaremos [GitHub CLI](https://cli.github.com/) para interagir com o GitHub diretamente do terminal. + +Ele já deve estar instalado no seu computador a partir dos comandos anteriores. + +Primeiro, para **fazer login**, copie e cole o seguinte comando em seu terminal: + +:warning: **NÃO edite o `email`** + +```bash +gh auth login -s 'user:email' -w +``` + +gh fará algumas perguntas: + +`What is your preferred protocol for Git operations?` With the arrows, choose `SSH` and press `Enter`. SSH é um protocolo para fazer login usando chaves SSH em vez do conhecido par nome de usuário/senha. + +`Generate a new SSH key to add to your GitHub account?` Pressione `Enter` para pedir ao gh gerar as chaves SSH para você. + +Se você já possui chaves SSH, verá `Upload your SSH public key to your GitHub account?` Com as setas, selecione o caminho do arquivo de sua chave pública e pressione `Enter`. + +`Enter a passphrase for your new SSH key (Optional)`. Digite algo que você deseja e que você lembrará. É uma senha para proteger sua chave privada armazenada no disco rígido. Em seguida, pressione `Enter`. + +`Title for your SSH key`. Você pode deixá-lo no "GitHub CLI" proposto, pressione `Enter`. + +Você obterá então a seguinte saída: + +```bash +! First copy your one-time code: 0EF9-D015 +- Press Enter to open github.com in your browser... +``` + +Selecione e copie o código (`0EF9-D015` no exemplo) e pressione `Enter`. + +Seu navegador será aberto e solicitará que você autorize o GitHub CLI a usar sua conta GitHub. Aceite e espere um pouco. + +Volte ao terminal, pressione `Enter` novamente e pronto. + +Para verificar se você está conectado corretamente, digite: + +```bash +gh auth status +``` + +:heavy_check_mark: Se você estiver `Logged in to github.com as `, então tudo bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +## Dotfiles (configuração padrão) + +Os hackers adoram refinar e aprimorar sua estrutura e ferramentas. + +Começaremos com uma ótima configuração padrão fornecida pelo Le Wagon: [`lewagon/dotfiles`](https://github.com/lewagon/dotfiles). + +Como sua configuração é pessoal, você precisa de seu próprio repositório para armazená-la. Então você irá fazer um **fork** do repositório Le Wagon. + +Bifurcar significa que você criará um novo repositório em sua própria conta GitHub `$GITHUB_USERNAME/dotfiles`, idêntico ao original do Le Wagon que você poderá modificar à vontade. + +Abra seu terminal e defina uma variável para seu nome de usuário GitHub: + +```bash +export GITHUB_USERNAME=`gh api user | jq -r '.login'` +``` + +```bash +echo $GITHUB_USERNAME +``` + +:heavy_check_mark: Você deverá ver seu nome de usuário do GitHub impresso. + +:x: Se não, **pare aqui** e peça ajuda. Pode haver um problema com a etapa anterior (`gh auth`). + +:warning: Por favor, note que esta variável só é definida para o tempo em que seu terminal está aberto. Se você fechá-lo antes ou durante as próximas etapas, será necessário configurá-lo novamente com as duas etapas acima! + + +É hora de fazer um fork do repositório e cloná-lo em seu computador: + +```bash +mkdir -p ~/code/$GITHUB_USERNAME && cd $_ +``` + +```bash +gh repo fork lewagon/dotfiles --clone +``` + +### Instalador do Dotfiles + +Execute o instalador `dotfiles`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles +``` + +```bash +zsh install.sh +``` + +Verifique os e-mails registrados em sua conta GitHub. Você precisará escolher um na próxima etapa: + +```bash +gh api user/emails | jq -r '.[].email' +``` + +:heavy_check_mark: Se você vir a lista de seus e-mails registrados, você pode prosseguir :+1: + +:x: Caso contrário, [reautentique-se no GitHub](https://github.com/lewagon/setup/blob/master/macos.md#github-cli) antes de executar este comando :point_up: novamente. + +### instalador git + +Execute o instalador `git`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh +``` + +:point_up: Isso **solicitará** seu nome (`Nome Sobrenome`) e seu e-mail. + +:warning: Você **precisa** colocar um dos e-mails listados acima graças ao comando anterior `gh api ...`. Se você não fizer isso, Kitt não conseguirá acompanhar seu progresso. + +Agora **reinicie** seu terminal executando: + +```bash +exec zsh +``` + +## Desativar prompt de senha SSH + +Você não quer que sua senha seja solicitada sempre que se comunicar com um repositório distante. Então, você precisa adicionar o plugin `ssh-agent` ao `oh my zsh`: + +Primeiro, abra o arquivo `.zshrc`: + +```bash +code ~/.zshrc +``` + +Então: +- Identifique a linha que começa com `plugins=` +- Adicione `ssh-agent` no final da lista de plugins + +:heavy_check_mark: Salve o arquivo `.zshrc` com `Ctrl` + `S` e feche seu editor de texto. + +## rbenv + +Vamos instalar o [`rbenv`](https://github.com/sstephenson/rbenv), um software para instalar e gerenciar ambientes `ruby`. + +Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter: + +```bash +rvm implode && sudo rm -rf ~/.rvm +# Se você obteve "zsh: command not found: rvm", continue. Isso significa que `rvm` não está +# no seu computador, e é isso que queremos! + +sudo rm -rf $HOME/.rbenv /usr/local/rbenv /opt/rbenv /usr/local/opt/rbenv +``` + +:warning: Este comando pode solicitar sua senha. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +Então no Terminal, rode + +```bash +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +``` + +```bash +git clone https://github.com/rbenv/rbenv.git ~/.rbenv +``` + +```bash +git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build +``` + +```bash +exec zsh +``` + +## Ruby + +### Instalação + +Agora, você está pronto para instalar a versão mais recente do [ruby](https://www.ruby-lang.org/en/) e defini-la como a versão padrão. + +Execute este comando, **demorará um pouco (5 a 10 minutos)** + +```bash +rbenv install 3.1.2 +``` + +Assim que a instalação do Ruby estiver concluída, execute este comando para informar ao sistema +para usar a versão 3.1.2 por padrão. + +```bash +rbenv global 3.1.2 +``` + +**Reinicialize** seu terminal e verifique sua versão do Ruby: + +```bash +exec zsh +``` + +Então rode: + +```bash +ruby -v +``` + +:heavy_check_mark: Se você vir algo começando com `ruby 3.1.2p` então você pode prosseguir :+1: + +:x: Se não, **pergunte a um professor** + +### Instalando algumas gems + +
+ Se você estiver na China 🇨🇳 clique aqui + + :warning: Se você estiver na China, você deve atualizar a forma como instalaremos as gems com os seguintes comandos. + +```bash +# Somente China! +gem sources --remove https://rubygems.org/ +gem sources -a https://gems.ruby-china.com/ +gem sources -l +#***FONTES ATUAIS*** +# https://gems.ruby-china.com/ +# Ruby-china.com deve estar na lista agora +``` +
+ +**Todos, na China ou não**, continuem aqui para instalar gems. + +No mundo Ruby, chamamos bibliotecas externas de `gems`: são pedaços de código Ruby que você pode baixar e executar em seu computador. Vamos instalar alguns! + +No seu terminal, copie e cole o seguinte comando: + +```bash +gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +``` + +:heavy_check_mark: Se você tiver `xx gems installed`, então tudo bem :+1: + +:x: Se você encontrar o seguinte erro: + +```bash +ERROR: While executing gem ... (TypeError) +incompatible marshal file format (can't be read) +format version 4.8 required; 60.33 given +``` + +Execute o seguinte comando: +```bash +rm -rf ~/.gemrc +``` + +Execute novamente o comando para instalar as gems. + +:warning: **NUNCA** instale uma gem com `sudo gem install`! Mesmo se você encontrar uma resposta do Stackoverflow (ou o terminal) solicitando que você faça isso. + +## Node.js + +[Node.js](https://nodejs.org/en/) é um JavaScript runtime para executar código JavaScript no terminal. Vamos instalá-lo com [nvm](https://github.com/nvm-sh/nvm), um gerenciador de versões para Node.js. + +Em um terminal, execute os seguintes comandos: + +```bash +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +nvm -v +``` + +Você deverá ver uma versão. Se não, pergunte a um professor. + +Agora vamos instalar o Node: + +```bash +nvm install 16.15.1 +``` + +Quando a instalação terminar, execute: + +```bash +node -v +``` + +Se você vir `v16.15.1`, a instalação foi bem-sucedida: heavy_check_mark: Você pode então executar: + +```bash +nvm cache clear +``` + +:x: Caso contrário, **entre em contato com um professor** + +## Yarn + +[`yarn`](https://yarnpkg.com/) é um gerenciador de pacotes para instalar bibliotecas JavaScript. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +npm install --global yarn +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +yarn -v +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** + +## SQLite + +Em algumas semanas falaremos sobre bancos de dados e SQL. [SQLite](https://sqlite.org/index.html) é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +sudo apt-get install sqlite3 libsqlite3-dev +``` + +Em seguida, execute o seguinte comando: + +```bash +sqlite3 -version +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** + +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential +``` + +```bash +sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;" +``` + +## Checagem + +Vamos verificar se você instalou tudo com sucesso. + +No seu terminal, execute o seguinte comando: + +```bash +exec zsh +``` + +Então rode: + +```bash +curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb +``` + +:heavy_check_mark: Se você receber uma mensagem verde `Incrível! Seu computador agora está pronto!`, então você está bem: +1: + +:x: Caso contrário, **entre em contato com um professor**. + +## Kitt + +:warning: Se você recebeu um e-mail do Le Wagon convidando você a se inscrever no Kitt (nossa plataforma de aprendizagem), você pode pular esta etapa com segurança. Em vez disso, siga as instruções no e-mail que você recebeu, caso ainda não tenha feito isso. + +Se não tiver certeza sobre o que fazer, siga [este link](https://kitt.lewagon.com/). Se você já estiver logado, pode pular esta seção com segurança. Se você não estiver logado, clique em `Enter Kitt as a Student`. Se você conseguir fazer login, poderá pular esta etapa com segurança. Caso contrário, pergunte a um professor se você deveria ter recebido um e-mail ou siga as instruções abaixo. + +Registre-se como alumni da Wagon acessando [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Selecione seu lote, faça login no GitHub e insira todas as suas informações. + +Seu professor irá então validar se você realmente faz parte do batch. Você pode pedir que eles façam isso assim que preencher o formulário de registro. + +Assim que o professor aprovar seu perfil, acesse sua caixa de entrada de e-mail. Você deve ter 2 e-mails: + +- Um do Slack, convidando você para a comunidade Le Wagon Alumni do Slack (onde você conversará com seus amigos e todos os ex-alunos anteriores). Clique em **Inscreva-se** e preencha os dados. +- Um do GitHub, convidando você para a equipe `lewagon`. **Aceite** caso contrário você não conseguirá acessar os slides da aula. + +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://slack.com/downloads/windows) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. + +### Configurações + +Inicie o aplicativo e faça login na organização `lewagon-alumni`. + +Certifique-se de **fazer upload de uma foto de perfil** :point_down: + +![Como fazer upload de uma foto de perfil no Slack](images/slack_profile_picture.gif) + +A ideia é que você tenha o Slack aberto o dia todo, para que você possa compartilhar links úteis/pedir ajuda/decidir onde ir almoçar/etc. + +Para garantir que tudo está funcionando bem nas videochamadas, vamos testar sua câmera e microfone: +- Abra o aplicativo Slack +- Clique na foto do seu perfil no canto superior direito. +- Selecione `Preferências` no menu. +- Clique em `Áudio e vídeo` na coluna do lado esquerdo. +- Abaixo de `Solução de problemas`, clique em `Executar um teste de áudio, vídeo e compartilhamento de tela`. O teste será aberto em uma nova janela. +- Verifique se seus dispositivos preferidos de alto-falante, microfone e câmera aparecem nos menus suspensos e clique em `Iniciar teste`. + +![Verifique o microfone e a webcam com o Slack](images/slack_call_test.png) + +:heavy_check_mark: Quando o teste terminar, você deverá ver mensagens verdes de "Sucesso" pelo menos para seu microfone e câmera. :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +Você também pode instalar o aplicativo Slack no seu telefone e entrar em `lewagon-alumni`! + +## Configurações do Windows + +### Troque arquivos entre Windows e Ubuntu + +Precisamos de uma maneira fácil de transferir arquivos do Windows para o Ubuntu e vice-versa. + +Para fazer isso, vamos criar atalhos para diretórios do Ubuntu no **File Explorer** do Windows: +- Abra o Windows File Explorer (ou use o atalho `WIN` + `E`) +- Na barra de endereços, digite `\\wsl$\` (ou `\\wsl$\Ubuntu` se não funcionar) +- Agora você tem acesso ao sistema de arquivos Ubuntu +- Mergulhe no sistema de arquivos Ubuntu para procurar diretórios de interesse +- Arraste as pastas desejadas para a barra de endereços para criar atalhos + +![Como adicionar um atalho ao sistema de arquivos Ubuntu no Windows](images/windows_ubuntu_file_system_shortcut.gif) + +### Abra o Windows File Explorer no terminal Ubuntu + +Outra opção para mover arquivos é abrir o Windows **File Explorer** no terminal Ubuntu: +- Abra um terminal Ubuntu +- Vá para o diretório que deseja explorar +- Execute o comando `explorer.exe .` (alternativamente, use `wslview .`) +- Se você receber uma mensagem de erro de entrada e saída, execute `wsl --shutdown` em um Windows PowerShell e reabra um terminal Ubuntu + +![Como iniciar o Windows Explorer a partir do terminal Ubuntu](images/windows_explorer_from_terminal.png) + +### Encontre o seu caminho no sistema de arquivos Ubuntu + +Você pode querer descobrir a localização exata de um diretório do Windows no sistema de arquivos Ubuntu ou vice-versa. + +Para converter um caminho do Windows de e para um caminho do Ubuntu: +- Abra um terminal Ubuntu +- Use o comando `wslpath "C:\Program Files"` para traduzir um caminho do Windows em um caminho do Ubuntu +- Use o comando `wslpath -w "/home"` para traduzir um caminho do Ubuntu em um caminho do Windows +- Em particular, o comando `wslpath -w $(pwd)` retorna o caminho do Windows do diretório atual do Ubuntu + +![Como acessar um caminho do Windows a partir do terminal Ubuntu](images/windows_path_from_terminal.png) + +### Fixe aplicativos na sua barra de tarefas + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Vamos fixá-los na barra de tarefas para que estejam a apenas um clique de distância! + +Para fixar um aplicativo na barra de tarefas, inicie o aplicativo, clique com o botão direito no ícone da barra de tarefas para abrir o menu de contexto e escolha “Fixar na barra de tarefas”. + +![Como fixar um aplicativo na barra de tarefas do Windows](images/windows_taskbar.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack +- Zoom + + +## Configuração concluída! + +Seu computador agora está pronto para o [curso de Desenvolvimento Web Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: + +Aproveite o bootcamp, você vai acertar :rocket: