O servidor de arquivos é um local para armazenar arquivos específicos do Salt, como arquivos "top" ou de estado, além de arquivos que podem ser distribuídos para subordinados, como arquivos de configuração do sistema. No espaço de trabalho Servidor de Arquivos, você pode exibir, criar e salvar arquivos de estado (YAML), módulos e arquivos de texto.
Os arquivos no SaltStack Config são úteis para configurar estados que você pode aplicar por meio de trabalhos. Trabalhos são usados para executar tarefas de execução remota, aplicar estados e iniciar executores Salt. Consulte Trabalhos para obter mais informações.
Arquivos também são usados para iterar em entradas de pilares em um pilar associado. Pilares são estruturas de dados definidos no mestre Salt e transmitidas a um ou mais subordinados usando destinos. Eles permitem que dados confidenciais e direcionados sejam enviados com segurança apenas ao subordinado relevante. Consulte Pilares.
No espaço de trabalho Servidor de Arquivos, é possível criar novos arquivos e clonar os existentes. Você também pode editar e excluir arquivos.
Acessando o espaço de trabalho Servidor de Arquivos
Para usar o espaço de trabalho Servidor de Arquivos, clique em Configuração > Servidor de Arquivos no menu lateral.
Criando um arquivo
Para criar um novo arquivo:
- No espaço de trabalho Servidor de Arquivos, clique em Criar.
- Em Base, insira o nome do ambiente base.
- Em Nome do Caminho, insira o caminho para o arquivo e o nome do arquivo.
Observação: Nomes de arquivos não precisam ser exclusivos, desde que os arquivos estejam em diferentes caminhos ou ambientes. Isso pode resultar na exibição de itens diferentes com o mesmo nome na interface do usuário do SaltStack Config.
- Insira o corpo do arquivo e clique em Salvar.
Agora, você pode visualizar o arquivo no servidor de arquivos. Somente Superusuários podem visualizar arquivos criados por outros usuários.
Clonando um arquivo
Para copiar ou duplicar um arquivo:
- No espaço de trabalho Servidor de Arquivos, selecione o arquivo que você deseja clonar.
- Clique em Clonar.
Uma cópia do arquivo agora está disponível no servidor de arquivos, com -2 anexado ao nome.
Excluindo um arquivo
Para excluir um arquivo:
- No espaço de trabalho Servidor de Arquivos, selecione o arquivo necessário.
- Clique em Excluir.
- Na caixa de diálogo de confirmação, clique em Confirmar.
Integração com servidores de arquivos existentes
Se você tiver back-ends de servidor de arquivos existentes configurados, como o Git ou o S3, eles continuarão funcionando conforme esperado, e os trabalhos criados e executados na interface do usuário poderão usar esses back-ends sem configuração adicional.
Se você planeja usar o servidor de arquivos do SaltStack Config em conjunto com outros servidores de arquivos, lembre-se de que os arquivos existentes na interface do usuário terão precedência se também existirem em outros servidores de arquivos.
fileserver_backend:
-sseapi
-roots
-git
É possível alterar esse comportamento reordenando as entradas na seção fileserver_backend do arquivo /etc/salt/master.d/raas.conf.
Ambientes
O servidor de arquivos do SaltStack Config fornece a capacidade de definir vários ambientes de arquivos.
Ambientes permitem isolar arquivos que têm o mesmo caminho e nome. Por padrão, arquivos e dados de pilares existem no ambiente base. Este é o ambiente que você seleciona ao criar um trabalho de execução de estado.
Você pode selecionar o ambiente no qual deseja criar um arquivo especificando-o durante a criação. Consulte Criando um arquivo.
Acesso ao servidor de arquivos
Os usuários não precisam de privilégios de servidor de arquivos para executar trabalhos. Por exemplo, se você criar um trabalho que executa o arquivo apache/init.sls (state.applyapache), os usuários com acesso a esse trabalho poderão executá-lo mesmo que não possam exibir, editar ou excluir o arquivo apache/init.sls diretamente.
Somente Superusuários podem visualizar arquivos criados por outros usuários. Somente as funções padrão Superusuário e Administrador recebem acesso para visualizar e fazer alterações no servidor de arquivos. Consulte Funções e permissões.
