> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/global-settings/global-settings-docs-pt-br/ambiente/topologias/visao-geral-das-topologias.md).

# Visão geral das topologias

## ![](https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FSxcnKlaJKPzDqONWoDNv%2FSummary2-Small-Icon.svg?alt=media\&token=5e3253d0-a069-4ba5-9c06-83c70bd0b21d) Visão geral

Este artigo explica o que é uma Topologia, como as Topologias agrupam suas organizações, como elas são gerenciadas e como afetam o DevOps. Para instruções passo a passo sobre como მუშაობar com Topologias, consulte os artigos a seguir.

* \[Em breve] Criando uma Topologia
* \[Em breve] Editando uma Topologia
* \[Em breve] Excluindo uma Topologia

{% hint style="info" %}
Somente usuários com a **SystemAdministrator** função podem criar e editar Topologias. Todos os outros usuários podem trabalhar dentro de uma Topologia no aplicativo DevOps com base nas permissões da organização.
{% endhint %}

## Como as Topologias Funcionam

Antes, o DevOps funcionava com um único conjunto de organizações conectadas. Isso dava a todo o tenant um contexto de trabalho compartilhado: uma base de código, um conjunto de branches, um conjunto de pull requests e um conjunto de pipelines. Se você usasse mais de um ambiente de produção do Salesforce, todos compartilhavam o mesmo contexto de trabalho.

Uma **Topologia** agrupa uma organização de Produção junto com as organizações de Desenvolvimento e Sandbox relacionadas a ela. Cada Topologia atua como um contexto de trabalho autônomo, com suas próprias organizações, branches, pull requests e pipelines. Um tenant pode ter tantas Topologias quantas precisar, permitindo que você mantenha ambientes de produção separados totalmente isolados uns dos outros.

### Tipos de Organização

Toda organização tem um **Tipo** que descreve sua função. **Produção** e **Sandbox** eram antes os únicos tipos, espelhando os dois tipos de org do Salesforce. As Topologias adicionam um terceiro tipo: **Desenvolvimento**. Uma Topologia pode conter qualquer número de organizações de Desenvolvimento e Sandbox, mas nunca mais de uma organização de Produção. Cada tipo é descrito abaixo:

<table><thead><tr><th width="140">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Produção</strong></td><td>Sua principal org de produção em operação, aquela em que o negócio funciona. Uma Topologia pode conter apenas uma.</td></tr><tr><td><strong>Desenvolvimento</strong></td><td>Qualquer outra org de produção do Salesforce usada para desenvolvimento ou teste, e não para operações comerciais em produção.</td></tr><tr><td><strong>Sandbox</strong></td><td>Uma sandbox do Salesforce.</td></tr></tbody></table>

{% hint style="info" %}

#### Produção e Desenvolvimento São Ambos Orgs de Produção do Salesforce

Do ponto de vista do Salesforce, não há diferença entre os tipos Produção e Desenvolvimento. Ambos são orgs de produção do Salesforce e ambos são conectados da mesma forma. A distinção existe no Flosum e identifica qual org é o seu ambiente de produção em operação.

Uma **Desenvolvimento** a organização do tipo não é uma org Salesforce Developer Edition. O tipo descreve como você usa a org, não a edição do Salesforce à qual ela está conectada.
{% endhint %}

{% hint style="warning" %}

#### Tipo vs Ambiente

Não confunda o **Tipo** de uma organização com seu rótulo de **Ambiente** . O **Ambiente** rótulo é um recurso de filtragem que não limita o que uma organização pode fazer. O **Tipo** determina se uma organização pode ser a organização de Produção em uma Topologia. Para saber mais sobre o rótulo Ambiente, consulte o artigo a seguir.

* [Atualizar um ambiente da organização](/global-settings/global-settings-docs-pt-br/ambiente/organizacoes/atualizar-um-ambiente-da-organizacao.md)
  {% endhint %}

### Topologias no aplicativo DevOps

No aplicativo DevOps, um seletor de Topologia permite que você alterne entre Topologias. Selecionar uma Topologia diferente altera todo o seu contexto de trabalho, então as organizações, branches, commits, pull requests e pipelines que você vê pertencem todos à Topologia selecionada. Para saber mais sobre como usar Topologias com o DevOps, consulte o artigo a seguir.

* [O que são topologias](/devops/devops-pt-br/informacoes-gerais/o-que-sao-topologias.md)

{% hint style="info" %}
No DevOps, todas as Topologias ficam visíveis para todos os usuários; no entanto, o acesso a organizações individuais ainda é controlado pelas permissões do DevOps.
{% endhint %}

## Migração para Topologias

Todos os tenants começam com uma **Padrão** Topologia, e todas as organizações existentes foram migradas para ela. As organizações marcadas anteriormente como Produção se tornaram Desenvolvimento, porque uma Topologia não contém mais de uma organização de Produção.

{% hint style="info" %}

#### Nenhuma ação é necessária

* Backup & Archive e Data Migrator não são afetados.
* O DevOps continua funcionando como antes, com todas as organizações na **Padrão** Topologia.
* Não é necessário marcar nenhuma organização como Produção.

Aja somente quando quiser aproveitar várias Topologias, o que significa criar Topologias adicionais e atribuir organizações a elas.
{% endhint %}

## Criando e Gerenciando Topologias

As Topologias são gerenciadas a partir da página **Topologias** em Configurações Globais. A página lista todas as Topologias do tenant, junto com sua organização de Produção e o número de organizações Sandbox e Desenvolvimento atribuídas a ela. Você pode criar uma Topologia a partir desta página ou ao conectar uma organização.

Cada Topologia tem uma página de detalhes que mostra seu nome, descrição, organização de Produção, contagem de organizações, datas de criação e atualização e a lista completa de organizações atribuídas. Você pode renomear uma Topologia a qualquer momento, e renomeá-la não afeta as organizações dentro dela nem nenhum trabalho em andamento. Você só pode excluir uma Topologia depois que todas as suas organizações tiverem sido removidas.

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FA9flXDwFBAP9bfSLAUur%2FOverviewOfTopologies-Topologies-01.png?alt=media&amp;token=ac9ab697-b3c3-4afd-bdba-ee357bed2eeb" alt="" width="563"><figcaption></figcaption></figure></div>

## Criando e Gerenciando Organizações

As organizações são atribuídas a uma Topologia quando você as cria. Durante o processo de criação, você seleciona uma Topologia existente ou cria uma nova sem sair do processo. Para saber como criar uma organização, consulte o artigo a seguir.

* [Criando uma organização](/global-settings/global-settings-docs-pt-br/ambiente/organizacoes/criando-uma-organizacao.md)

{% hint style="warning" %}

#### Alterando Topologias

Depois que uma organização é atribuída a uma Topologia, ela não pode ser movida para outra Topologia. Essa restrição protege seu contexto de trabalho do DevOps e evita os efeitos indesejados de mover uma organização entre contextos.

Se precisar mover uma organização para uma Topologia diferente, exclua a organização e crie-a novamente com a Topologia desejada. Ao excluir uma organização, você perderá qualquer informação específica dessa organização, especialmente os backups do aplicativo Backup & Archive.
{% endhint %}

Como uma Topologia não contém mais de uma organização de Produção, as Configurações Globais validam isso quando você conecta uma organização de Produção. Se a Topologia selecionada já tiver uma, as Configurações Globais bloqueiam a ação e exibem um aviso.

A **Organizações** lista inclui uma **Topologia** coluna, para que você possa ver a qual Topologia cada organização pertence sem abrir sua página de detalhes. Cada organização também tem uma opção **Marcar como Produção** , que altera o tipo da organização de Desenvolvimento para Produção. Se a Topologia já tiver uma organização de Produção, uma mensagem de erro é exibida.

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FgwAZLeSZTuL0lJK7G2Lz%2FOverviewOfTopologies-Topologies-02.png?alt=media&amp;token=cc7c8ce5-2cd3-4727-860c-9f0509d3bcfc" alt="" width="563"><figcaption></figcaption></figure></div>

## Como as Topologias Afetam as Funções

A **Gerenciar permissões da organização** na seção dos formulários Criar Função e Editar Função agora é **permissões da Topologia**e se aplica ao Backup & Archive, DevOps e Data Migrator. Quando uma Topologia é adicionada a uma função, todas as organizações da Topologia são listadas. No entanto, as permissões individuais ainda são atribuídas por organização, e suas permissões existentes permanecem inalteradas.

Para saber como funções, grupos e usuários trabalham juntos, consulte os artigos a seguir.

* [Visão geral de funções, grupos e usuários](/global-settings/global-settings-docs-pt-br/gerenciamento-de-usuarios/visao-geral-de-funcoes-grupos-e-usuarios.md)
* [Criando uma função](/global-settings/global-settings-docs-pt-br/gerenciamento-de-usuarios/funcoes/criando-uma-funcao.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/global-settings/global-settings-docs-pt-br/ambiente/topologias/visao-geral-das-topologias.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
