# Integração com GitHub

## ✅ **Pré-requisitos**

{% stepper %}
{% step %}
**Consistência da Conta GitHub**

{% hint style="warning" %}
A conta GitHub usada para **login na Discloud** E **propriedade do repositório deve ser a mesma.**
{% endhint %}

> **Consequências de incompatibilidade**:
>
> * Repositórios não aparecerão
> * Falhas de uploads
> * Erros de permissão
>   {% endstep %}

{% step %}
**Arquivo** [**`discloud.config`**](https://docs.discloud.com/configurations/discloud.config) **Válido**

Deve existir no **diretório raiz** do seu repositório.

> ⚠️ **A validação falha se**:
>
> * Arquivo ausente
> * Sintaxe inválida
>   {% endstep %}
>   {% endstepper %}

***

## 🔄 **Conectar GitHub e Configurar Acesso**

{% stepper %}
{% step %}
Iniciar Conexão GitHub

* Vá para [Painel Discloud](https://discloud.com/dashboard) → aba **Integração GitHub**
* Clique em **Login** → Autorize Discloud via GitHub OAuth

  <figure><img src="https://696530983-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvUqkKIFudeQ2TQOirm35%2Fuploads%2F4HFNVox5FNVOg0M0amkC%2FGitHub-Integration_Login.png?alt=media&#x26;token=bc94cd44-b6f4-43cc-952b-984e9437ce13" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
Configurar Acesso ao Repositório

* Volte para **Integração GitHub** → Clique em **Configurar**
* Escolha o alvo da instalação.
* Defina permissões:
  * 🔓 *Todos os repositórios*
  * 🔒 *Selecionar repositórios específicos*
    {% endstep %}
    {% endstepper %}

***

## 🚀 **Upload do GitHub**

{% stepper %}
{% step %}
**Iniciar Upload**

* Vá para [Painel Discloud](https://discloud.com/dashboard)
* Clique em "**+ Upload"** (canto superior direito)
* Selecione "**GitHub"** no menu
  {% endstep %}

{% step %}
**Configuração e Upload**

{% hint style="info" %}

#### **🔐 Variáveis de Ambiente Seguras**

Use arquivos [`.env`](https://docs.discloud.com/faq/general-questions/.env-file) localmente para desenvolvimento, mas certifique-se de que eles sejam adicionados ao `.gitignore` para evitar exposição acidental no GitHub. Ao fazer o upload via integração GitHub da Discloud, **adicione segredos de produção diretamente na seção "Variáveis de Ambiente"** durante a configuração.
{% endhint %}
{% endstep %}
{% endstepper %}

<figure><img src="https://696530983-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvUqkKIFudeQ2TQOirm35%2Fuploads%2Fgit-blob-49f5887d16f7aa476dd37fd1002075c3acf57e3b%2FGitHub-Integration_Upload.gif?alt=media" alt=""><figcaption></figcaption></figure>