5.0 KiB
Bem-vindo(a) ao ambiente de desenvolvimento — Ipiranga Agroindustrial
Este documento reúne as premissas e regras de negócio dos sistemas:
- Git (repositórios de código).
- Portainer (gestão de containers).
Leia com atenção — ele explica o que você pode acessar, como fazer login e a quem recorrer quando precisar de algo novo.
Princípios gerais (valem para os dois sistemas)
Nosso ambiente segue três princípios básicos:
- Acesso mínimo. Cada pessoa enxerga e manipula apenas os recursos do seu setor. Você não verá repositórios ou containers de outras áreas — isso é intencional e protege todo mundo de acidentes.
- Cadastro controlado. Contas não são criadas por autocadastro. Um administrador cria a sua conta manualmente, com o seu e-mail corporativo, e te adiciona ao setor correto. Ninguém entra sozinho, mesmo tendo conta Microsoft válida.
- Login pela Microsoft. A autenticação é feita com a sua conta corporativa
(
@ipirangaagro.com.br) via Microsoft. Você não precisa memorizar uma senha separada para esses sistemas.
Como fazer login
Ambos os sistemas ficam atrás do nosso firewall e são acessados por HTTPS:
Na tela de login, clique em "Entrar com a Microsoft" e use sua conta corporativa.
Primeiro acesso ao Gitea: na primeira vez, o sistema pode pedir uma vinculação única entre sua conta Microsoft e a conta local. O T.I. te orienta nesse passo — ele acontece só uma vez; depois disso, o login é direto pela Microsoft.
Gitea — regras de negócio
O Gitea guarda nosso código-fonte, organizado por setor.
Organizações por setor. Cada área tem sua própria organização (ex.: ipiranga-agricola,
ipiranga-fiscal, ipiranga-ti). Uma organização é isolada das outras — você só enxerga
a(s) organização(ões) da(s) qual(is) é membro.
Repositórios são privados. Todo repositório é privado e visível apenas para os membros do setor com acesso a ele. Não crie repositórios públicos.
Papéis dentro do setor. Cada organização de setor tem:
- Um ou mais gestores (acesso de administrador aos repositórios do setor: podem criar, configurar e gerenciar repositórios daquela área).
- Membros com acesso de leitura ou escrita, conforme a necessidade da função.
- O T.I. central, que pode ter acesso de leitura para dar suporte.
O que você provavelmente NÃO pode fazer (a menos que seja liberado):
- Criar novas organizações (esse direito é concedido individualmente, caso a caso).
- Apagar a organização do setor (isso é exclusivo dos administradores).
- Ver ou acessar repositórios de outros setores.
Precisa de um repositório novo ou de acesso a um existente? Fale com o gestor do seu setor (para repositórios da sua área) ou com o T.I. (para acessos entre áreas).
Portainer — regras de negócio
O Portainer gerencia os containers das aplicações. O acesso também é por setor.
Segmentação por time. Cada setor é um "time" no Portainer. Você é adicionado ao time da sua área e passa a ver apenas os recursos (stacks e containers) daquele time.
Acesso restrito às stacks do seu setor. As aplicações do seu setor são organizadas em stacks marcadas como restritas ao seu time. Você consegue operar (iniciar, parar, reiniciar, ver logs) apenas os containers do seu setor.
O que você NÃO vê: stacks, containers, volumes e redes de outros setores, nem recursos administrativos do servidor.
Precisa de acesso a uma nova aplicação? Fale com o T.I. — a inclusão de um recurso ao seu time é feita por um administrador.
Como pedir mudanças de acesso
Como o modelo é de acesso mínimo, mudanças são feitas por um administrador. Ao pedir, informe:
- Seu nome e e-mail corporativo.
- O setor / organização em questão.
- O que você precisa (ex.: acesso a um repositório específico, criar uma nova aplicação, permissão para criar organizações).
- O motivo / contexto do pedido.
Isso agiliza a liberação e mantém o registro de quem tem acesso a quê.
Contatos
- Gestor do seu setor: responsável pelos repositórios e aplicações da sua área.
- T.I. central: para acessos entre setores, novas contas, novas organizações/stacks e suporte geral.
Resumo rápido
| Tema | Gitea | Portainer |
|---|---|---|
| Unidade de isolamento | Organização (por setor) | Time (por setor) |
| Visibilidade | Só a(s) sua(s) organização(ões) | Só as stacks do seu time |
| Login | Microsoft | Microsoft |
| Criação de conta | Manual, pelo admin | Manual, pelo admin |
| Repositórios / recursos | Sempre privados | Restritos ao time |
| Pedir mais acesso | Gestor do setor ou T.I. | T.I. |
Este documento reflete as premissas atuais do ambiente e pode ser atualizado conforme a empresa cresce. Em caso de dúvida, procure o T.I.