# Kubecost Integration

## Plataforma FinOps Pier - Configurações de integração com Kubecost

#### Bem-vindo à Pier Cloud!

Esse documento possui como objetivo ser um guia para que você possa preparar o ambiente, a fim de que seja possível conectar a plataforma da Pier Cloud com o Kubecost utilizando conexão via API.

### No ambiente do Kubecost

{% hint style="success" %}
PRE REQUISITO: 

Para integração com a plataforma da Pier Cloud, será necessário criar uma API Key no Kubecost.
{% endhint %}

A seguir, você encontrará um passo a passo detalhado de como realizar essa configuração.

#### Geração da API Key

1. Para iniciar a configuração, acesse a interface do **Kubecost** e faça login com uma conta de **admin**.
2. No menu lateral, clique em **Teams** e em seguida selecione o cabeçalho **Service Accounts**.
3. Clique em **Add Service Account**.
4. Dê um nome ao novo serviço de conta e clique em **Create**.

{% hint style="info" %}
Uma vez atribuído um nome ao serviço de conta, não será possível alterá-lo depois.
{% endhint %}

5. O Kubecost gerará uma chave de API automaticamente. **Copie e salve essa chave imediatamente**, usando o ícone de copiar antes de fechar o painel

{% hint style="warning" %}
Após fechar o painel, a chave **não ficará acessível posteriormente**!
{% endhint %}

### **Na Plataforma da Pier Cloud:**

#### **Criação do Segredo**

1. Na Plataforma, acesse o ícone do usuário e selecione a opção de **Configurações**, conforme ilustrado abaixo:

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FXSV6noJTP8paYHH5tM5e%2Fimage.png?alt=media&#x26;token=b218f657-4bf0-4e5f-bd4d-8984bd0321ef" alt=""><figcaption></figcaption></figure>

2. O sistema irá apresentar o Menu de funcionalidades lateral a esquerda. Clique na opção **Segredos** e em seguida no botão **+ Adicionar** no canto superior à direita, para criar o Segredo.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FNh5eMvB3UC4s4SrDWCQ4%2Fimage%20(1).png?alt=media&#x26;token=86a7011b-0add-4432-95d3-8074a570da74" alt=""><figcaption></figcaption></figure>

3. Nesse passo vamos configurar o segredo com as informações geradas na plataforma do Kubecost:

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FucEFDZPp0vJKSOPqcBQ1%2Fimage.png?alt=media&#x26;token=db233fed-5b52-4472-977f-2316d4d08992" alt="" width="563"><figcaption></figcaption></figure>

4. Nesse passo vamos inserir as seguintes informações:

* **Nome**: Insira um nome para identificar o Segredo.
  * Exemplo: "Kubecost API\_Key".&#x20;
* **Tipo**: Selecione o tipo de Segredo "**API Key"**.&#x20;
* **API Key**: Insira a chave da API gerada no passo 5, no ambiente do Kubescost.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2F7FotlTo3oN6q5uWAJmWo%2Fimage.png?alt=media&#x26;token=363c7f9b-b61c-4a21-9efd-60b5a141ca6d" alt="" width="563"><figcaption></figcaption></figure>

5. Por fim, clique em **Salvar** para concluir a criação do Segredo.

**Pronto, o Segredo para o Kubecost foi criado com sucesso!**&#x20;

#### Criação do **Data Connectors**

1. No menu de funcionalidades a esquerda, clique na opção **Data Connectors** e em seguida no botão **+ Adicionar** no canto superior à direita, para criação do Data Connector.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FWjoovXDLDF5VlrHUafb1%2Fimage.png?alt=media&#x26;token=65a4178a-6306-4988-93ec-db99124f9ead" alt=""><figcaption></figcaption></figure>

2. Nesse passo vamos configurar o Data Connector:

* **Data Connector:** selecione o tipo de conector de dados Kubecost.
* **Nome do Identificador do Data Connector:** insira um nome para identificar o conector.
  * Exemplo: "Kubecost".&#x20;
* **Selecione o segredo para este conector de dados:** escolha o segredo criado no passo 5 da Criação do Segredo.
* **Endpoint:** insira o endpoint que devemos consultar.&#x20;

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FSBZ8huxKeCwyyXHDdKpB%2Fimage.png?alt=media&#x26;token=30f106cd-f72b-469c-9a51-662211a01a06" alt=""><figcaption></figcaption></figure>

3. Por fim, clique em Salvar para criar o conector de dados.

**Pronto, Data Connectors do Kubecost criado com sucesso!**&#x20;