Instruções de configuração

Você encontrará abaixo as instruções para configurar seu computador para o curso de AI Software Development Le Wagon.

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 para soluções e dicas de problemas comuns :heavy_check_mark:

Vamos começar :rocket:

Conta GitHub

Você se inscreveu no GitHub? Caso contrário, faça isso imediatamente.

:point_right: Carregue uma imagem 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.

:point_right: Ative a Autenticação em Duas Etapas (2FA). O GitHub enviará mensagens de texto com um código quando você tentar fazer login. Isso é importante para a segurança e em breve será necessário para contribuir com código no GitHub.

Visual Studio Code

Instalação

Vamos instalar o editor de texto Visual Studio Code.

Copie (Ctrl + C) os comandos abaixo e cole-os em seu terminal (Ctrl + Shift + v):

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg

sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/

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'

rm -f packages.microsoft.gpg

sudo apt update

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:

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:

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 shopify.ruby-lsp
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
code --install-extension marcoroth.herb-lsp
code --install-extension rayhanw.erb-helpers

Aqui está uma lista das extensões que você está instalando:

• Sublime Text Keymap and Settings Importer
• VSCode Great Icons
• Live Share
• Ruby
• ESLint
• Paste and Indent
• SQLite

Recursos de IA no VS Code

O VS Code inclui muitos recursos poderosos de IA, que são ótimas ferramentas quando você já sabe programar.

Dito isso, confiar na IA muito cedo pode ocultar conceitos importantes e dificultar o entendimento da depuração. Quando você estiver confortável com os fundamentos, saberá quando e como usar a IA de forma eficaz — sem deixar que ela faça o raciocínio por você.

Para o início do bootcamp, vamos desativar esses recursos. No momento certo do curso, os reativaremos para que você possa usá-los bem.

Em VS Code:

1. Vamos abrir a "Paleta de Comandos" do VS Code: digite Ctrl-Shift-P (Windows / Linux) ou Cmd-Shift-P (macOS).
2. Isso abrirá a Paleta de Comandos: uma pequena caixa de texto no topo da tela. Comece a digitar aifeatures até ver "Chat: Learn How to Hide AI features". Clique nela.
3. Isso abrirá as configurações e mostrará a opção "Disable and hide built-in AI features ...". Marque a caixa de seleção à frente dessa opção.

Mais tarde, se quiser reativar os recursos de IA, você pode seguir as mesmas instruções para desmarcar a caixa.

Configuração do Live Share

Visual Studio 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:

• 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 continuar!

Ferramentas de linha de comando

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:

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:

sudo locale-gen en_US.UTF-8

Se, depois, receberes um aviso (bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)) no teu terminal, por favor faz o seguinte:

sudo update-locale LANG=en_US.UTF8
sudo apt-get update
sudo apt-get install language-pack-en language-pack-en-base manpages

Zsh e Git

Em vez de usar o bash shell, usaremos zsh.

Também usaremos git, 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:

sudo apt update

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 (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:

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

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

sudo apt update

sudo apt install -y gh

Para verificar se gh foi instalado com sucesso em sua máquina, você pode executar:

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.

Em um terminal execute o seguinte comando:

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:

:heavy_check_mark: Se isso acontecer, você pode continuar :+1:

:x: Caso contrário, por favor entre em contato com um professor

CLI do GitHub

CLI é o acrônimo de Interface de linha de comando.

Nesta seção, usaremos GitHub CLI para interagir com o GitHub diretamente do terminal.

Usaremos o GitHub CLI (gh) para conectar ao GitHub usando SSH, um protocolo para fazer login usando chaves SSH em vez do conhecido par nome de usuário/senha.

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 — Mesmo que user:email pareça um espaço reservado para seu endereço de e-mail real, não é — não o substitua.

gh auth login -s 'user:email' -w --git-protocol ssh

gh fará algumas perguntas:

• 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):

  • PARA A MAIORIA DOS ALUNOS: Apenas pressione Enter para pular. Você não precisa de uma senha para o bootcamp e ela seria solicitada toda vez que você usar a chave. Há, no entanto, um risco de que se alguém roubar seu laptop, ele possa enviar código para o GitHub.
  • SE A SEGURANÇA É MUITO IMPORTANTE PARA VOCÊ: Digite uma senha de sua escolha e pressione Enter. É muito importante que se você inserir uma senha, anote-a em algum lugar imediatamente e não a perca nem a esqueça. Você precisará digitá-la com frequência.

• Title for your SSH key. Você pode deixá-lo no "GitHub CLI" proposto, pressione Enter.

Você obterá então a seguinte saída:

! 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:

gh auth status

:heavy_check_mark: Se você estiver Logado no github.com como <SEU NOME DE USUÁRIO> , 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.

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:

export GITHUB_USERNAME=`gh api user | jq -r '.login'`

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:

mkdir -p ~/code/$GITHUB_USERNAME && cd $_

gh repo fork lewagon/dotfiles --clone

Instalador do Dotfiles

Execute o instalador dotfiles:

cd ~/code/$GITHUB_USERNAME/dotfiles

zsh install.sh

Verifique os e-mails registrados em sua conta GitHub. Você precisará escolher um na próxima etapa:

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 antes de executar este comando :point_up: novamente.

Instalador git

Execute o instalador git:

cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh

:point_up: Isso solicitará seu nome (Nome Sobrenome) e seu e-mail. O email que você escolher será exibido publicamente na internet. 💡 Selecione o endereço @users.noreply.github.com se você não deseja que seu e-mail apareça em repositórios públicos aos quais você possa contribuir.

: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:

exec zsh

Isso recarrega seu shell para que ele incorpore a nova configuração.

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:

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, um software para instalar e gerenciar ambientes ruby.

Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter:

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:

sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev

git clone https://github.com/rbenv/rbenv.git ~/.rbenv

git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

exec zsh

Ruby

Instalação

Agora, você está pronto para instalar a versão mais recente do ruby e defini-la como a versão padrão.

Execute este comando, demorará um pouco (5 a 10 minutos)

rbenv install 3.3.5

Assim que a instalação do Ruby estiver concluída, execute este comando para informar ao sistema para usar a versão 3.3.5 por padrão.

rbenv global 3.3.5

Reinicialize seu terminal e verifique sua versão do Ruby:

exec zsh

Então corra:

ruby -v

:heavy_check_mark: Se você vir algo começando com ruby 3.3.5 então você pode prosseguir :+1:

:x: Se não, pergunte a um professor

Instalando algumas gems

# 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:

gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp

:heavy_check_mark: Se você tiver xx gems installed, então tudo bem :+1:

:x: Se você encontrar o seguinte erro:

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:

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.

Node.js

Node.js é um tempo de execução JavaScript para executar código JavaScript no terminal. Vamos instalá-lo com nvm, um gerenciador de versões para Node.js.

Em um terminal, execute os seguintes comandos:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh

exec zsh

Em seguida, execute o seguinte comando:

nvm -v

Você deverá ver uma versão. Se não, pergunte a um professor.

Agora vamos instalar o Node.js:

nvm install 20.17.0

Quando a instalação terminar, execute:

node -v

Se você vir v20.17.0, a instalação foi bem-sucedida :heavy_check_mark: Você pode então executar:

nvm cache clear

:x: Caso contrário, entre em contato com um professor

Yarn

yarn é um gerenciador de pacotes para instalar bibliotecas JavaScript. Vamos instalá-lo:

Em um terminal, execute os seguintes comandos:

corepack enable
yarn set version stable

exec zsh

⚠️ Se vires quaisquer mensagens de erro, tenta executar npm install -g corepack e, em seguida, volta a executar os comandos acima.

Em seguida, execute o seguinte comando:

yarn -v

:heavy_check_mark: Se você vir uma versão, você está bem :+1:

:x: Se não, entre em contato com um professor

SQLite

Em algumas semanas falaremos sobre bancos de dados e SQL. SQLite é 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:

sudo apt-get install sqlite3 libsqlite3-dev pkg-config

Em seguida, execute o seguinte comando:

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, um sistema de banco de dados de código aberto, robusto e pronto para produção.

Vamos instalá-lo agora.

Execute os seguintes comandos:

sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential

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:

exec zsh

Então corra:

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.

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. 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. 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.

Slack

Slack é uma plataforma de comunicação bastante popular na indústria de tecnologia.

Instalação

Baixe o aplicativo Slack 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:

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.

: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:

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.

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:

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".

Você deve fixar:

• Seu terminal
• Seu explorador de arquivos
• VS Code
• Seu navegador de Internet
• Slack

Configuração concluída!

Seu computador agora está pronto para o curso de AI Software Development Le Wagon :muscle: :clap:

Aproveite o bootcamp, você vai acertar :rocket: