amanda-lima / env-config

Configuração básica de ambiente Linux para desenvolvedores.

Configuração de Ambiente de Desenvolvimento

Por: @amanda-lima

Neste documento será demonstrado o passo a passo da configuração do ambiente de desenvolvimento para uma máquina Linux Ubuntu.

Serão instaladas as ferramentas:

• Chrome;
• VSCode;
• Git;
• PHP;
• Node (NVM);
• Docker;
• Docker Compose;
• Portainer.io;
• XAMPP;

Para realizar a instalação dessas ferramentas neste sistema iremos utilizar o Terminal Linux.

Instalando o Chrome:

• Baixando o pacote mais recente do Google Chrome:

  wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb

• Instalando o pacote .deb:

  sudo apt install ./google-chrome-stable_current_amd64.deb

• Durante o processo de instalação, o repositório oficial do Google será adicionado ao seu sistema. Você pode usar o comando cat para verificar o conteúdo do arquivo:

  cat /etc/apt/sources.list.d/google-chrome.list

• Esse comando deverá retornar o seguinte output:

  ### THIS FILE IS AUTOMATICALLY CONFIGURED ###
  # You may comment out this entry, but any other modifications may be lost.
  deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main

---

Instalando o VSCode:

Iremos instalar o VScode pela própria loja de aplicativos do Ubuntu e instalar os plugins: PHPIntelephense, MySQL (cweijan) e Docker.

---

Instalando o Git:

O Git é um sistema de controle de versão de arquivos. Através deles podemos desenvolver projetos na qual diversas pessoas podem contribuir simultaneamente no mesmo, editando e criando novos arquivos e permitindo que os mesmos possam existir sem o risco de suas alterações serem sobrescritas.

• Verificando se existem atualizações e atualizando os pacotes já existentes:

  sudo apt-get update && sudo apt-get upgrade

• Instalando o Git:

  sudo apt install git

• Verificando a versão instalada:

  git --version

Configurando o Git:

• Definindo user name:

  git config --global user.name "Your Name"

• Definindo email:

  git config --global user.email "[email protected]"

• Verificando configurações:

  git config --list

Configurando chave SSH:

• Verificando chaves SSH:

    ls -al ~/.ssh

• Gerando nova chave SSH:

  • Abra o Git Bash/Terminal;

  • Cole o texto abaixo, substituindo o endereço de e-mail pelo seu GitHub.

    ssh-keygen -t ed25519 -C "[email protected]"

  • Quando aparecer a solicitação "Enter a file in which to save the key" (Insira um arquivo no qual salvar a chave), presssione Enter. O local padrão do arquivo será aceito.

  • Será criada uma chave (se definido caminho padrão) em: /home/<your-user>/.ssh/id_ed25519.pub

  • Abra o arquivo criado com o comando abaixo:

    cat /home/<your-user>/.ssh/id_ed25519.pub

  • Copie a chave que será exibida no terminal, e colaremos em nosso github, em configurações > SSH & GPG Keys

    ssh-ed25519 <hash-random-key> [email protected]

---

Instalando o PHP 7.4:

• Verificando se existem atualizações e atualizando os pacotes já existentes:

  sudo apt-get update && sudo apt-get upgrade

• Instalando o PHP:

  sudo apt-get install php

• Verificando a versão instalada:

  php -v

---

Instalando o Node (via NVM):

Source: Tutorial DigitalOcean

O Node.js pode ser definido como um ambiente de execução Javascript server-side. Isso significa que com o Node.js é possível criar aplicações Javascript para rodar como uma aplicação standalone em uma máquina, não dependendo de um browser para a execução, como estamos acostumados.

O nvm é um gerenciador de versões do Node. E é usado para instalar e gerenciar suas versões.

Para instalar o NVM em sua máquina Ubuntu 20.04, visite a página do GitHub do projeto. Copie o comando curl do arquivo README, mostrado na página principal. Isso dará a você a versão mais recente do script de instalação.

Instalando o NVM

• Execute o comando abaixo com o | bash anexado no final para que o script possa ser baixado e executado:

  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

• Isso instalará o script nvm em sua conta de usuário. Para usá-lo, você deve antes gerar seu arquivo .bashrc:

  cat ~/.bashrc

Instalando o Node via NVM

• Para instalar a versão mmais recente, utilizaremos o comando:

  nvm install node

• Para instalar uma versão diferente, iremos listar quais versões do Node estão disponíveis em nosso NVM:

  nvm list-remote

• Instale uma versão do Node digitando qualquer uma das versões que estiver vendo. Por exemplo, para obter a versão v13.6.0, digite:

  nvm install v13.6.0

• Para verificarmos a versão instalada, utilizaremos o comando:

  node -v

---

Instalando o Docker:

Source: Tutorial DigitalOcean

O Docker é um aplicativo que simplifica o processo de gerenciamento de processos de aplicação em containers. Os containers deixam você executar suas aplicações em processos isolados de recurso. Eles são semelhantes a máquinas virtuais, mas os containers são mais portáveis, mais fáceis de usar e mais dependentes do sistema operacional do host.

Instalando Docker

• Primeiro, atualize sua lista existente de pacotes:

    sudo apt update

• Em seguida, instale alguns pacotes de pré-requisitos que permitem ao apt usar pacotes sobre HTTPS:

    sudo apt install apt-transport-https ca-certificates curl software-properties-common

• Em seguida, adicione a chave GPG para o repositório oficial do Docker ao seu sistema:

    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

• Adicione o repositório Docker às fontes APT:

    sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"

• Em seguida, atualize o banco de dados de pacotes com os pacotes Docker do repo recém-adicionado:

    sudo apt update

• Certifique-se de que está prestes a instalar a partir do repositório Docker em vez do repositório Ubuntu padrão:

    apt-cache policy docker-ce

  Observe que docker-ce não está instalado, mas o candidato para instalação é do repositório Docker para Ubuntu 20.04 (focal). Finalmente, instale o Docker:

      sudo apt install docker-ce

• O Docker agora deve estar instalado, o daemon iniciado e o processo habilitado para iniciar na inicialização. Verifique se ele está funcionando:

      sudo systemctl status docker #para linux

Executando o comando Docker sem Sudo (opcional)

• Se quiser evitar digitar sudo sempre que executar o comando docker, adicione seu nome de usuário ao grupo docker:

    sudo usermod -aG docker ${USER}

• Para aplicar a nova associação de grupo, saia do servidor e entre novamente ou digite o seguinte:

    su - ${USER}

• Você será solicitado a inserir sua senha de usuário para continuar.

• Confirmando se o seu usuário foi adicionado ao grupo docker digitando:

    id -nG

    #Output
    sammy sudo docker

• Listando docker:

    docker ps

• Executando docker teste:

    docker run hello-world

Instalando o Docker Compose (utilizaremos 1.28.2)

• Baixando docker-compose:

    sudo curl -L "https://github.com/docker/compose/releases/download/1.28.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

• Dando permissão de execução para docker-compose:

    sudo chmod +x /usr/local/bin/docker-compose

• Verificando versão:

    docker-compose --version

---

Instalando o Portainer.io

O Portainer é uma ferramenta para ajudar na administração de seus containers, sejam eles locais, ou rodando em modo "swarm". Resumidamente, o Portainer é um ótimo front-end para Docker.

Instalando o Portainer

• Crie um volume para o Portainer com o seguinte comando:

  docker volume create portainer_data

• Instalando o portainer:

  docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce

  Observação: o parâmetro -v /var/run/docker.sock:/var/run/docker.sock serve apenas para servidores e ambientes Linux.

• Verificando se o container está de pé:

  docker ps
  

• Em seguida, acesse o seu servidor na porta 9000 para prosseguir a instalação:

  http://localhost:9000/

• Preencha um nome de usuário e senha:

  

• Em seguida, você deve selecionar qual tipo de instalação deseja realizar. Note que é possível administrar vários serviços de containeres, inclusive remotos. Vamos selecionar,por ora, a opção Local:

  

• Agora selecione o servidor e começar a utilizar:

  

• Aqui são encontrados as informações e controles sobre containers, imagens, volumes, etc.

  

---

Instalando o XAMPP

Tutorial Point Comunicação

O XAMPP é um pacote que oferece um ambiente de desenvolvimento onde você pode desenvolver um software para a web ou criar um website com todas as ferramentas necessárias.

Instalando o XAMPP

• Baixando o pacote mais recente do XAMPP:

  wget https://www.apachefriends.org/xampp-files/7.4.19/xampp-linux-x64-7.4.19-0-installer.run

• Alterando a permissão do instalador. 755 significa acesso de leitura e execução para todos e também acesso de gravação para o proprietário do arquivo.

  chmod 755 xampp-linux-x64-7.4.19-0-installer.run

• Executando o instalador:

  sudo ./xampp-linux-x64-7.4.19-0-installer.run

Assistente de Instalação

• No momento em que você executar o comando de instalação, um assistente de configuração do XAMP será aberto. Clique no botão Avançar .

  

• Selecione os componentes “Arquivos XAMPP Core” e arquivos XAMPP Developer e, em seguida, AVANÇAR.

  

• Por padrão, todos os arquivos serão descompactados em /opt/lampp.

  

  

  

Criando atalho:

• Copiando o icone do XAMPP para a pasta do lampp:

  sudo cp -i /opt/lampp/htdocs/favicon.ico /opt/lampp/icons/

• Crie um lançador para o programa executando o comando abaixo:

  echo -e '[Desktop Entry]\n Version=1.0\n Name=xampp\n Exec=lxqt-sudo /opt/lampp/manager-linux-x64.run\n Icon=/opt/lampp/icons/favicon.ico\n Type=Application\n Categories=Application' | sudo tee /usr/share/applications/xampp.desktop

• Para que o atalho funcione corretamente, instale o LXQT com o comando abaixo.

  sudo apt-get install lxqt-sudo

• Coloque o atalho na sua área de trabalho usando o comando abaixo:

  sudo chmod +x /usr/share/applications/xampp.desktop

  cp /usr/share/applications/xampp.desktop ~/Desktop