Compartilhar via

Workspaces – alterações significativas (junho de 2024)

  • Artigo

APLICA-SE A: Desenvolvedor | Standard | Premium

Importante

Se você criou workspaces após a versão geralmente disponível de workspaces em julho de 2024, seus workspaces não devem ser afetados por essas alterações.

Após 14 de junho de 2024, como parte do desenvolvimento de workspaces no Gerenciamento de API do Azure, estamos introduzindo várias alterações significativas.

Após 14 de junho de 2024, seus workspaces e APIs gerenciados neles poderão parar de funcionar se ainda dependerem dos recursos definidos para serem alterados. APIs e recursos gerenciados fora dos workspaces não são afetados por essa alteração.

Meu serviço é afetado por essas alterações?

Seu serviço poderá ser afetado por essas alterações se você tiver configurado workspaces (versão prévia) em sua instância de Gerenciamento de API. Esse recurso foi introduzido nas camadas Premium, Standard e Developer .

Alterações da falha

Revise as seguintes alterações significativas para determinar se você precisa tomar medidas:

Alterar nas camadas de serviço com suporte

As seguintes camadas de serviço não darão mais suporte a workspaces: Standard e Developer. Os espaços de trabalho estarão disponíveis na camada Premium .

Para obter disponibilidade nas camadas v2, consulte Camadas do Gerenciamento de API do Azure v2.

Alterações no suporte para atribuição de entidades de nível de serviço em workspaces

As seguintes atribuições de entidades de espaço de trabalho a entidades de nível de serviço não terão mais suporte:

  • Atribuir APIs de workspace a produtos de nível de serviço

  • Atribuir APIs de workspace a tags de nível de serviço

  • Atribuir produtos de espaço de trabalho a tags de nível de serviço

  • Atribuir grupos de nível de serviço a produtos de espaço de trabalho para controles de visibilidade

    Observação

    Os grupos internos de Convidados e Desenvolvedores continuarão disponíveis nos workspaces.

Alterações em objetos de contexto com suporte

Os seguintes context objetos não terão mais suporte nas políticas de workspace ou na política de todas as APIs no nível de serviço:

  • context.Api.Workspace
  • context.Product.Workspace

O context.Workspace objeto pode ser usado em vez disso.

Observação

Você pode continuar a fazer referência a usuários do nível de serviço no context objeto em políticas no nível do workspace.

Qual é o prezo para a mudança?

As alterações significativas serão introduzidas após 14 de junho de 2024. É altamente recomendável que você faça todas as alterações necessárias na configuração dos espaços de trabalho antes dessa data.

O que preciso fazer?

Se seus espaços de trabalho forem afetados por essas alterações, você precisará atualizar suas configurações de espaço de trabalho para se alinhar aos novos recursos.

Clientes da camada Standard

Se você estiver usando workspaces na camada Standard , atualize para a camada Premium para continuar usando workspaces.

Clientes do nível de desenvolvedor

A camada Developer foi projetada para casos de uso de usuário único ou equipe única. Não é possível facilitar a colaboração de várias equipes com espaços de trabalho devido aos recursos de computação limitados, falta de SLA e falta de redundância de infraestrutura. Se você estiver usando a visualização de workspaces na camada Desenvolvedor , poderá escolher uma das seguintes opções:

  • Agregar em uma instância da camada Premium

    Embora a atualização de cada instância do nível Developer para o nível Premium seja uma opção, considere agregar vários ambientes de não produção em uma única instância do nível Premium. Use workspaces na camada Premium para isolar os diferentes ambientes.

  • Usar instâncias da camada Developer para desenvolvimento, migrar para workspaces na camada Premium para produção

    Você pode usar instâncias de nível de desenvolvedor para ambientes de desenvolvimento. Para ambientes superiores, você pode migrar a configuração de cada serviço da camada de desenvolvedor para um workspace de um serviço da camada Premium, por exemplo, usando pipelines de CI/CD. Com essa abordagem, você pode ter problemas ou conflitos ao gerenciar as configurações entre ambientes.

    Se você estiver usando workspaces em uma instância de nível de desenvolvedor, poderá migrar as configurações de workspace para uma instância de nível de desenvolvedor sem workspaces:

    1. Exporte um modelo do Resource Manager da instância de Gerenciamento de API. Você pode exportar o modelo do portal do Azure ou usando outras ferramentas.
    2. Remova a seguinte subcadeia de caracteres dos valores de ID do recurso: /workspaces/[^/]+
    3. Implante o modelo. Para obter mais informações, consulte Início Rápido: Criar e implantar modelos do ARM usando o portal do Azure.

    Dependendo do seu caso de uso, talvez seja necessário executar outras alterações de configuração em sua instância de Gerenciamento de API.

Atribuição de entidades no nível do workspace

Se você atribuiu entidades de nível de workspace a entidades de nível de serviço na visualização de workspaces, consulte a tabela a seguir para obter diretrizes de migração.

Não há mais suporte para atribuição Etapa de migração recomendada
Atribuir APIs de workspace a produtos de nível de serviço Usar produtos no nível do workspace
Atribuir APIs ou produtos do workspace a tags de nível de serviço Usar tags no nível do workspace

Ajuda e suporte

Em caso de dúvidas, fale com os especialistas da comunidade no Microsoft Q&A. Se tiver um plano de suporte e precisar de ajuda técnica, crie uma solicitação de suporte.

Mais informações

Conteúdo relacionado

Confira todas as próximas alterações interruptivas e as desativações de recursos.