macos.pt.md
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:
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.
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.
Durante esta configuração, você será solicitado a sair e reabrir os aplicativos várias vezes. Certifique-se de fazer isso corretamente :pray:
Abra um novo terminal, copie e cole o seguinte comando e pressione Enter:
xcode-select --install
Se você receber a mensagem a seguir, basta pular esta etapa e ir para a próxima.
# 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.
: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:
sudo softwareupdate --clear-catalog
Feito isso, você pode tentar instalar novamente.
Homebrew é 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:
/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 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:
# ⚠️ 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:
brew update
Se você receber um erro /usr/local deve ser gravável, basta executar isto:
sudo chown -R $USER:admin /usr/local
brew update
Continue executando o seguinte no terminal (você pode copiar/colar todas as linhas de uma vez).
brew upgrade git || brew install git
brew upgrade gh || brew install gh
brew upgrade wget || brew install wget
brew upgrade imagemagick || brew install imagemagick
brew upgrade jq || brew install jq
brew upgrade openssl || brew install openssl
Vamos instalar o editor de texto Visual Studio Code.
Copie (Cmd + C) o comando abaixo e cole-o em seu terminal (Cmd + V):
brew install --cask visual-studio-code
Em seguida, inicie o VS Code executando o seguinte comando em seu 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
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:
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:
Ctrl-Shift-P (Windows / Linux) ou Cmd-Shift-P (macOS).aifeatures até ver "Chat: Learn How to Hide AI features". Clique nela.
Mais tarde, se quiser reativar os recursos de IA, você pode seguir as mesmas instruções para desmarcar a caixa.
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:
É isso, você está pronto para continuar!
Inicie um terminal, clique em Terminal > Preferências e defina o tema "Pro" como perfil padrão.
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.
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 é 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
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). 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:
! 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.
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
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.
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
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
# 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:
brew uninstall --force rbenv ruby-build
exec zsh
Então rode:
brew install rbenv libyaml
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
:warning: Se você estiver na China, você deve atualizar a forma como instalaremos o gem com os seguintes comandos.
# 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 é 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 é 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
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:
brew install sqlite
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
À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:
brew install postgresql@15 libpq
brew link --force libpq
brew services start postgresql@15
Depois de fazer isso, vamos verificar se funcionou:
psql -d postgres
Você deverá ver um novo prompt como este :point_down:
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 entre em contato com um professor
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.
: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:
lewagon. Aceite caso contrário você não conseguirá acessar os slides da aula.Slack é uma plataforma de comunicação bastante popular na indústria de tecnologia.
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.
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:
Preferências no menu.Áudio e vídeo na coluna do lado esquerdo.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.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!
É obrigatório que você proteja sua sessão com uma senha. Se ainda não for o caso, vá para > Ajustes do Sistema > Usuários e Grupos e altere a senha da sua conta. Você também deve ir para > Ajustes 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 > Ajustes do Sistema > Controle daVelocidade de repetição de teclaVelocidade de repetição de Escritorio y Dock e clicar no botão cantos de acesso rápido (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.
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.
Vá para > Preferências do Sistema > Teclado. Defina Velocidade de repetição de tecla para a posição mais rápida (à direita) e Atraso da repetição para a posição mais curta (à direita).
Leia este script e escolha algumas coisas que você acha que combinam com você. Por exemplo, você pode digitar no terminal este:
# 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..
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".
Você deve fixar:
Seu computador agora está pronto para o curso de AI Software Development Le Wagon :muscle: :clap:
Aproveite o bootcamp, você vai acertar :rocket: