# Integração Kubecost

## 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://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FKlJ0ABMqmght3EDFz2uh%2Fimage.png?alt=media&#x26;token=8204eccd-6b86-4624-89cb-5a2df092504f" 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://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FSDhfty2x7kuQw69hfxyn%2Fimage%20(1).png?alt=media&#x26;token=a3f63acf-85b1-4be2-9cc8-9434c76fb56d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FM92gpxyYnWBckqiIvK2H%2Fimage.png?alt=media&#x26;token=c4af33f0-d794-4e42-a558-7a7c8fc5030a" 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://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FuLbxNL5kr9pxcRUD7TQ7%2Fimage.png?alt=media&#x26;token=aab1a3ea-a653-4f74-bf38-204edf8e2168" 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://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FvMizCrncp7m1ySWDAERn%2Fimage.png?alt=media&#x26;token=53dfaf2d-b102-44f3-bf3b-0f8e00760872" 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://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FKj6lA17zFFKQz4dx00jR%2Fimage.png?alt=media&#x26;token=7640408b-76d1-4e09-9f6a-0745e0d8d6c6" 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;