Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Políticas Enterprise para gerenciamento de extensões

As políticas Enterprise no Devin Desktop permitem que as organizações gerenciem centralmente as configurações do editor para suas equipes de desenvolvimento, garantindo consistência e segurança em toda a organização. Quando um valor de política é definido, ele faz override de uma configuração do Devin Desktop definida em qualquer nível (padrão, usuário e workspace). Admins de TI podem implantar e aplicar configurações específicas do Devin Desktop nos dispositivos dos usuários por meio de diferentes soluções de gerenciamento de dispositivos. O Devin Desktop oferece suporte à aplicação de políticas no Windows, macOS e Linux.
O Devin Desktop usa seus próprios caminhos de política, separados dos do VS Code. As políticas configuradas para o VS Code não se aplicam ao Devin Desktop, e vice-versa.

​
Políticas de Grupo do Windows

O Devin Desktop oferece suporte à Política de Grupo baseada no Registro do Windows. As políticas podem ser implantadas com soluções de Mobile Device Management (MDM) ou configuradas manualmente em dispositivos individuais.
O Devin Desktop lê as políticas no caminho do registro Software\Policies\Windsurf\{ProductName} (por exemplo, Software\Policies\Windsurf\Windsurf ou Software\Policies\Windsurf\WindsurfInsiders). Isso é diferente do VS Code, que lê em Software\Policies\Microsoft\{ProductName}.

​
Etapa 1: Obtenha os arquivos ADMX e ADML

Cada versão do Devin Desktop vem com um diretório policies que contém arquivos de template ADMX que definem as políticas disponíveis. Você pode obter os arquivos ADMX e ADML de uma instalação existente do Devin Desktop:
  1. Navegue até o diretório de instalação do Devin Desktop.
  2. Procure a pasta policies. Essa pasta contém os arquivos de template ADMX (e.g. windsurf.admx) e uma subpasta locales com arquivos ADML para diferentes idiomas.
Como alternativa, baixe e extraia o arquivo ZIP do Devin Desktop e localize a pasta policies nos arquivos extraídos.

​
Etapa 2: Instale os arquivos de definição de política

  1. Copie o arquivo windsurf.admx para C:\Windows\PolicyDefinitions.
  2. Copie o arquivo ADML apropriado da subpasta locales (por exemplo, en-US\windsurf.adml) para C:\Windows\PolicyDefinitions\<your-locale> (por exemplo, C:\Windows\PolicyDefinitions\en-US).
Você precisa de privilégios de administrador para copiar arquivos para o diretório PolicyDefinitions.
Em ambientes com Active Directory, copie os arquivos ADMX e ADML para o Central Store para disponibilizar as políticas em todo o domínio.

​
Etapa 3: Implantar as políticas

Você pode implantar as políticas configuradas em larga escala usando uma solução de MDM ou testá-las manualmente em uma máquina local com o Editor de Política de Grupo Local.

​
Implantar em escala

Produtos como Microsoft Intune ou a Política de Grupo do Active Directory podem ser usados para gerenciar centralmente políticas de dispositivos em grande escala. Essas soluções permitem que administradores implantem os arquivos ADMX/ADML e as configurações de política em vários dispositivos a partir de um ponto central.

​
Testar políticas manualmente em uma máquina local

Siga estas etapas para configurar políticas do Devin Desktop em uma máquina Windows local usando o Editor de Política de Grupo Local:
  1. Abra o Editor de Política de Grupo Local:
    • Pressione Windows+R para abrir a caixa de diálogo Executar.
    • Digite gpedit.msc e pressione Enter.
    • Se for exibido um prompt do Controle de Conta de Usuário, selecione Sim.
  2. Navegue até as políticas do Windsurf:
    • Configuração do Computador > Modelos Administrativos > Windsurf
    • Configuração do Usuário > Modelos Administrativos > Windsurf
As políticas no nível do computador têm precedência sobre as políticas no nível do usuário quando ambas estão configuradas.
  1. Configure uma política:
    • Clique duas vezes na política que você deseja configurar (por exemplo, AllowedExtensions).
    • Selecione Ativado para impor a política.
    • Para políticas de string (por exemplo, AllowedExtensions), insira o valor no campo de texto. Por exemplo: {"publisher1": true, "publisher2": true}.
    • Para políticas booleanas (por exemplo, EnableTelemetry), selecionar Ativado ou Desativado define o valor.
    • Selecione OK para salvar as alterações.
Se houver um erro de sintaxe em um valor de política de string (por exemplo, JSON malformado), a configuração não será aplicada. Você pode verificar os erros no log da janela no Devin Desktop (abra a Paleta de Comandos com Ctrl+Shift+P e digite Show Window Log).
A política entrará em vigor na próxima vez que o Devin Desktop for iniciado.

​
Perfis de configuração do macOS

Os perfis de configuração gerenciam as configurações em dispositivos macOS. Um perfil é um arquivo XML (.mobileconfig) com pares de chave-valor que correspondem às políticas disponíveis. Esses perfis podem ser distribuídos usando soluções de gerenciamento de dispositivos móveis (MDM) ou instalados manualmente em dispositivos individuais.

​
Etapa 1: Obtenha o perfil de configuração de exemplo

Cada versão do Devin Desktop inclui um arquivo .mobileconfig de exemplo. Para localizar esse arquivo em um dispositivo macOS com o Devin Desktop instalado:
  1. Abra o Finder e navegue até /Applications.
  2. Clique com o botão direito em Windsurf.app e selecione Mostrar Conteúdo do Pacote.
  3. Navegue até Contents/Resources/app/policies.
  4. Localize o arquivo .mobileconfig de exemplo.

​
Etapa 2: Configurar os valores da política

  1. Copie o arquivo .mobileconfig de exemplo para um local de trabalho (por exemplo, a pasta Área de Trabalho ou Documentos).
  2. Abra o arquivo copiado em um editor de texto.
  3. Edite os valores da política de acordo com seus requisitos:
Políticas de string — políticas que aceitam valores de texto ou strings JSON: 
<!-- Exemplo: Permitir extensões de editores específicos -->
<key>AllowedExtensions</key>
<string>{"publisher1": true, "publisher2": true}</string>
Políticas booleanas — políticas que aceitam valores true/false: 
<!-- Exemplo: Ativar feedback do usuário -->
<key>EnableFeedback</key>
<true/>

<!-- Exemplo: Desativar telemetria -->
<key>EnableTelemetry</key>
<false/>
Remova as políticas desnecessárias — exclua a chave e o valor de qualquer política que você não queira aplicar.
Se houver um erro de sintaxe no valor da política, a configuração não será aplicada. Você pode consultar o log da janela no Devin Desktop para verificar erros (abra a Paleta de Comandos com ⌘+Shift+P e digite Show Window Log).

​
Etapa 3: Implante as políticas

​
Faça a implantação em escala

Para implantações Enterprise em vários dispositivos, use soluções de Mobile Device Management (MDM), como o Apple Business Manager com MDM. Para mais informações sobre perfis de configuração, consulte a documentação da Apple sobre perfis de configuração.

​
Testar políticas manualmente em uma máquina local

  1. Instale o perfil de configuração:
    • Salve o arquivo .mobileconfig editado.
    • Clique duas vezes no arquivo .mobileconfig no Finder.
    • Configurações do Sistema será aberto. Revise os detalhes do perfil e selecione Instalar.
    • Se solicitado, autentique-se com suas credenciais de administrador.
  2. Verifique a instalação do perfil:
    • Abra Configurações do Sistema.
    • Vá para Privacidade e Segurança > Perfis (ou Geral > Gerenciamento de Dispositivos em versões mais antigas).
    • Verifique se o perfil de configuração do Devin Desktop aparece na lista.
    • Abra o Devin Desktop para ver as políticas em vigor.
As políticas entram em vigor imediatamente para novas instâncias do Devin Desktop. Talvez seja necessário reiniciar o Devin Desktop se ele já estiver em execução.

​
Remover um Perfil de Configuração

Para remover políticas e restaurar as configurações padrão:
  1. Abra Configuração do Sistema > Privacidade e Segurança > Perfis.
  2. Selecione o perfil de configuração do Devin Desktop.
  3. Selecione o botão Remover (ou -).
  4. Autentique-se com suas credenciais de administrador para confirmar a remoção.

​
Políticas JSON no Linux

Você pode configurar as políticas de definições do Devin Desktop em dispositivos Linux colocando um arquivo de política JSON em /etc/windsurf/policies/policy.json. Essa abordagem usa um formato JSON simples para definir os valores das políticas.
O Devin Desktop lê as políticas de /etc/windsurf/policies/policy.json, enquanto o VS Code usa /etc/vscode/policy.json. Certifique-se de colocar o arquivo no local correto para o Devin Desktop.

​
Etapa 1: Obtenha o arquivo de política de exemplo

Cada versão do Devin Desktop vem com um arquivo policy.json de exemplo. Você pode obtê-lo em uma instalação existente — ele fica no diretório resources/app/policies dentro do caminho de instalação do Devin Desktop.

​
Etapa 2: Configurar os valores da política

  1. Copie o arquivo de exemplo policy.json para um local de sua preferência:
sudo cp /path/to/windsurf/resources/app/policies/policy.json /tmp/policy.json
  1. Edite o arquivo com o editor de texto de sua preferência:
sudo nano /tmp/policy.json
  1. Defina os valores da política. Por exemplo, para permitir apenas publicadores específicos de extensões:
{
  "AllowedExtensions": "{\"publisher1\": true, \"publisher2\": true}",
  "UpdateMode": "manual"
}

​
Etapa 3: Aplicar as políticas

​
Implantação em larga escala

Para implantações do Linux Enterprise em vários dispositivos, use ferramentas de gerenciamento de configuração, como Ansible, Puppet, Chef ou Salt, para implantar o arquivo policy.json. Essas ferramentas permitem que os administradores implantem, atualizem e removam políticas remotamente em todos os dispositivos Linux gerenciados.

​
Teste manualmente as políticas em uma máquina local

  1. Crie o diretório de políticas e copie o arquivo:
sudo mkdir -p /etc/windsurf/policies
sudo cp /tmp/policy.json /etc/windsurf/policies/policy.json
sudo chmod 644 /etc/windsurf/policies/policy.json
sudo chown root:root /etc/windsurf/policies/policy.json
Você precisa de privilégios de root ou sudo para criar o diretório e gerenciar arquivos de política em /etc/windsurf/policies.
  1. Verifique a instalação das políticas:
    • Abra o Devin Desktop (ou reinicie-o, se ele já estiver em execução).
    • Abra File > Preferences > Settings (ou pressione Ctrl+,).
    • Procure configurações que correspondam às políticas configuradas — elas devem aparecer como gerenciadas pela sua organização ou com um ícone de cadeado.

​
Remover políticas

Para remover todas as políticas e restaurar as configurações padrão, exclua o arquivo /etc/windsurf/policies/policy.json e reinicie o Devin Desktop.

​
Políticas de gerenciamento de extensões

Um dos usos mais comuns das políticas do Enterprise é controlar quais extensões os usuários podem instalar. A política AllowedExtensions permite que os administradores definam uma lista de permissões com os publicadores de extensões autorizados.

​
AllowedExtensions

A política AllowedExtensions aceita uma string JSON que especifica quais editores de extensões são permitidos. Quando essa política está ativa, os usuários só podem instalar extensões dos editores listados. Valor de exemplo: 
{"windsurf": true, "github": true, "ms-python": true}
Isso pode ser configurado por qualquer um dos mecanismos específicos de cada plataforma descritos acima:
  • Windows: Defina por meio de modelos ADMX de Política de Grupo ou diretamente no registro em Software\Policies\Windsurf\{ProductName}.
  • macOS: Defina em um perfil de configuração .mobileconfig.
  • Linux: Defina em /etc/windsurf/policies/policy.json.
Quando a política AllowedExtensions é aplicada, a seção de extensões no Devin Desktop indica que a configuração é gerenciada pela sua organização, e os usuários não podem alterá-la.

​
Recursos adicionais