Introdução ao RStudio + GitHub

ESTAT0109 – Mineração de Dados em Estatística

Prof. Dr. Sadraque E. F. Lucena
sadraquelucena@academico.ufs.br
http://sadraquelucena.github.io/mineracao

Objetivo da aula

  • Entender o que é e para que serve o e o .
  • Saber como criar um repositório de projeto.
  • Atualizar repositório no via .

Breve introdução ao

O que é o ?

  • Git é uma ferramenta que ajuda a controlar e gerenciar mudanças em arquivos ao longo do tempo.

  • Ele permite que você salve versões diferentes de um trabalho à medida que faz alterações, de modo que possa voltar para versões anteriores se algo der errado ou se precisar revisar mudanças feitas.

Por que o é importante?

  • Evita perda de trabalho: Se você estiver escrevendo código ou criando qualquer tipo de documento, o Git permite que você salve diferentes versões do seu trabalho. Assim, se algo der errado, você pode voltar a uma versão anterior.

  • Facilita o trabalho em equipe: Quando várias pessoas estão trabalhando no mesmo projeto, o Git permite que cada uma trabalhe de forma independente e depois una os trabalhos de maneira organizada. Isso evita que as alterações de uma pessoa sobrescrevam as de outra.

  • Organização e rastreamento: O Git mantém um histórico completo de todas as mudanças feitas em um projeto, permitindo saber quem fez o quê e quando.

O que é o ?

  • GitHub é uma plataforma online que armazena e organiza projetos que utilizam Git.

  • Ele permite que você publique seu código, compartilhe arquivos e colabore com outras pessoas em projetos de forma fácil e eficiente.

Por que o é importante?

  • Armazenamento seguro: Com o GitHub, seus projetos ficam seguramente armazenados na nuvem. Isso significa que você pode acessar seu trabalho de qualquer lugar e sempre terá uma cópia segura.

  • Colaboração em equipe: GitHub permite que várias pessoas trabalhem no mesmo projeto ao mesmo tempo. Cada pessoa pode fazer mudanças no código, e o GitHub ajuda a gerenciar essas mudanças sem que uma sobrescreva a outra.

  • Histórico e transparência: O GitHub mantém um histórico completo de todas as alterações feitas no seu projeto. Isso permite ver quem fez o quê e quando, facilitando o acompanhamento e revisão do trabalho de equipe.

Como e por que usar o na disciplina?

  • Você receberá um script em R a cada aula

  • Durante a aula, vai editar esse script no RStudio, testando e resolvendo problemas

  • No final da aula, envia suas alterações para seu repositório (push) — tudo salvo e organizado

  • Pode acessar seu trabalho de qualquer lugar, com segurança e histórico garantido

GitHub será seu caderno digital de códigos — inteligente, seguro e acessível para a disciplina

Primeiros passos

  1. Baixar e instalar o Git: https://happygitwithr.com/install-git.html

  2. Criar uma conta no GitHub: https://github.com/

  3. Criar um reposítório Git

  4. Clone esse repositório para sua máquina usando o RStudio

  5. Trabalhe no projeto e envie as atualizações de volta ao GitHub

Desenvolva o hábito de buscar soluções por conta própria. Isso faz parte do dia a dia de quem trabalha com dados. Comece agora a desenvolver essa autonomia.

Criando um repositório no

  • Após fazer login no GitHub, Clique em + no canto superior direito

  • Em seguida, clique em New repository

Criando um repositório no

  1. Em Repository name dê um anome ao repositóro

  2. Em Description faça uma descrição do repositório

  3. Marque a opção Public ou Private

  4. Em Initialize this repository with: marque a opção Add a README file

  5. Clique em Create repository

  • Com o repositório já criado no GitHub, agora vamos usar o RStudio para ligar o projeto local ao repositório remoto.

  • Assim, todas as alterações feitas no RStudio poderão ser salvas na nuvem e versionadas automaticamente.

  • Para enviar essas alterações ao GitHub, será necessário se autenticar — com login e senha ou com um token de acesso.

    • Vamos ver como criar um token de acesso no GitHub.

Criando um token de acesso no

  1. Estando logado no GitHub, clique na sua foto de perfil no canto superior direito
  2. Clique em Settings

Criando um token de acesso no

  1. No canto inferior esquerdo da tela clique em Developer settings

Criando um token de acesso no

  1. No canto superior esquerdo da tela clique em Personal access tokens

  2. Clique em Tokens (classic)

  1. Em Expiration selecione a data em que o token irá expirar

  2. Marque todas as opções em Select scopes

  3. Clique em Generate token

O token será gerado uma única vez. Guarde-o com cuidado, pois não será possível visualizá-lo novamente no GitHub. Você usará esse token quando for solicitada autenticação.

Integrando e

+ : integração prática

  • O RStudio possui integração nativa com o Git e GitHub

    • Ou seja, é possível sincronizar um repositório GitHub a um repositório local

    • Isso significa que você pode ligar o repositório do GitHub (na nuvem) ao seu projeto no computador. Assim, o que você altera localmente pode ser enviado para o GitHub — e vice-versa.

  • Para isso, seguimos os seguintes passos:

+ : integração prática

  1. Fazemos uma cópia do repositório do GitHub na máquina local usando o RStudio.

    • Quando já há uma cópia na máquina, começamos o trabalho atualizando o projeto local com as alterações que estão no GitHub (pull).

  2. Trabalhamos normalmente no projeto: scripts, análises, relatórios…

  3. Usamos o Git para registrar as alterações (commit) e enviar para o GitHub (push).

+ : criando o projeto local

  1. No canto superior direito do RStudio clique em File > New Project

  2. Clique em Version control


+ : criando o projeto local

  1. Clique em Git

+ : criando o projeto local

  1. No campo Repository URL, cole a URL do repositório que você criou no GitHub

  2. Em Create project as subdirectory of, escolha o diretório em que o repositório do GitHub será copiado na máquina local

  3. Clique em Create Project

+ : criando o projeto local

  • Se você estiver clonando um repositório público, o RStudio irá criar uma cópia do projeto localmente, sem exigir login.

  • Se o repositório for privado, o GitHub pedirá que você se autentique (login e senha ou token).


  • Uma vez que já existe o projeto na máquina local, você só precisa acessar o diretório local (pasta) e clicar no arquivo com extensão .Rproj para abrir o projeto no Rstudio, sem necessidade de clonar o projeto novamente na máquina.

Atualizando o repositório no

Enviando alterações para o via

  • Depois de salvar as atualizações do seu projeto local, você pode enviar essas alterações para o repositório no GitHub diretamente pelo RStudio. Você deve fazer:
  1. No quadrante superior direito clique em Commit

Enviando alterações para o via

  1. RStudio mostra os arquivos que foram alterados. Selecione-os.

  2. No campo Commit message escreva um comentário contendo o que foi atualizado (sugestão: não use caracteres especiais ou acentos)

  3. Clique em Commit

Enviando alterações para o via

Enviando alterações para o via

  1. Após finalizado o envio, clique em Close

Enviando alterações para o via

  1. Note que irá aparecer a mensagem Your branch is ahead of 'origin/master' by 1 commit (isto indica que você tem alterações ainda não enviadas ao GitHub)

  2. Clique em Push

Enviando alterações para o via

  1. Em máquinas com Windows o Rstudio redirecionará para você fazer login na sua conta GitHub no seu navegador. Em Linux preencha o campo Username for 'https://github.com' coloque login e clique em OK

Enviando alterações para o via

  1. Ainda em Linux, no campo Personal Access Token insira o token criado no GitHub

  2. Clique em OK

Enviando alterações para o via

  1. Caso apareça a mensagem abaixo, os arquivos foram atualizados no repositório do GitHub.

Material Extra

Aprofunde o que vimos em aula com esses vídeos no YouTube:

Ganhos da aula

  • Versionamento de código e arquivos com GitHub

  • Integração do RStudio com GitHub

  • Experiência com ferramentas do mercado

Atividade extraclasse

Configure seu ambiente de trabalho pessoal

Objetivo

Deixar seu computador pessoal pronto para continuar os trabalhos da disciplina fora do laboratório, de forma independente.

Etapas:

Criar um repositório da disciplina do GitHub, clonar via RStudio para a sua máquina local e fazer seu primeiro commit.

Fim