Aplicativo e implantação no Azure Spring Apps

Observação

Azure Spring Apps é o novo nome do serviço Azure Spring Cloud. Embora o serviço tenha um novo nome, você verá o nome antigo em alguns locais por um tempo enquanto trabalhamos para atualizar ativos como capturas de tela, vídeos e diagramas.

Este artigo aplica-se a: ✔️ Java ✔️ C#

Este artigo se aplica ao: ✔️ nível Básico/Standard ✔️ nível Enterprise

Os conceitos Aplicativo e Implantação são os dois principais conceitos no modelo de recurso do Azure Spring Apps. No Azure Spring Apps, um Aplicativo é uma abstração de um aplicativo de negócios. Uma versão do código ou binário implantado como Aplicativo é executado em uma Implantação. Os aplicativos são executados em uma instância de serviço do Azure Spring Apps ou simplesmente em uma instância de serviço, conforme mostrado a seguir.

Diagram showing the relationship between the apps and deployments.

Você pode ter várias instâncias de serviço em uma única assinatura do Azure, mas o Serviço do Azure Spring Apps é mais fácil de usar quando todos os aplicativos que compõem um aplicativo de negócios residem em uma única instância de serviço. Um dos motivos é que os aplicativos provavelmente se comunicarão entre si. Eles podem fazer isso facilmente usando o registro de serviço Eureka na instância de serviço.

O plano Azure Spring Apps Standard permite que um Aplicativo tenha uma implantação de produção e uma implantação de preparo, para que você possa fazer a implantação azul/verde nele facilmente.

Aplicativo

Os recursos/propriedades a seguir são definidos no nível do aplicativo.

Recursos Descrição
Ponto de extremidade
público
A URL para acessar o aplicativo.
Domínio
personalizado
O CNAME registro que protege o domínio personalizado.
Vinculação
serviço
A conexão pronta para uso com outros serviços do Azure.
Identidade
gerenciada
A identidade gerenciada pela ID do Microsoft Entra permite que seu aplicativo acesse facilmente outros recursos protegidos do Microsoft Entra, como o Cofre de Chaves do Azure.
Armazenamento
persistente
A configuração que permite que os dados persistam além da reinicialização do aplicativo.

Implantação

Os recursos/propriedades a seguir são definidos no nível de implantação e são trocados ao trocar a implantação de produção e preparo.

Recursos Descrição
CPU O número de vcores por instância do aplicativo.
Memória O GB de memória por instância do aplicativo.
Contagem
instâncias
O número de instâncias do aplicativo, definido manualmente ou automaticamente.
Dimensionamento automático A contagem de instâncias de escala é contada automaticamente com base em regras e agendamentos predefinidos.
Opções
JVM
As opções da JVM a serem definidas.
variáveis
ambientais
As variáveis de ambiente a serem definidas.
Versão
Runtime:
Java 8 ou Java 11.

Ambiente

Os Aplicativos de Primavera do Azure montam alguns arquivos YAML somente leitura em seus aplicativos implantados. Esses arquivos contêm o contexto do Azure de uma implantação. A lista a seguir mostra os caminhos e o conteúdo desses arquivos YAML:

  • /etc/azure-spring-cloud/context/azure-spring-apps.yml

    AZURE_SPRING_APPS:
        SUBSCRIPTION_ID:  <your-azure-subscription-id>
        RESOURCE_GROUP: <your-resource-group-name>
        NAME: <your-azure-spring-apps-name>
    
  • /etc/azure-spring-cloud/context/azure-spring-apps-deployment.yml

    AZURE_SPRING_APPS:
         APP:
            NAME: <your-app-name>
         DEPLOYMENT:
            NAME: <your-deployment-name>
            ACTIVE: true # true if the deployment is in production, false if in staging
    

Se seu aplicativo for um aplicativo Spring Boot, esses dois caminhos de arquivo serão adicionados à SPRING_CONFIG_ADDITIONAL_LOCATION variável de ambiente. Dessa forma, seu aplicativo pode carregar essas propriedades como configurações e usá-las em seu código. Por exemplo, você pode usar a anotação para vincular as propriedades YAML a @ConfigurationProperties uma classe Java. O trecho de código a seguir mostra como criar uma @Configuration classe que representa o contexto do Azure:

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;

@Configuration
@ConfigurationProperties(prefix = "azure-spring-apps")
@Data
public class AzureSpringAppsContext {

    private String subscriptionId;
    private String resourceGroup;
    private String name;

    private AppContext app;
    private DeploymentContext deployment;

    @Data
    public static class AppContext {
        private String name;
    }

    @Data
    public static class DeploymentContext {
        private String name;
        private boolean active;
    }
}

Para quaisquer outros aplicativos poliglotas, talvez seja necessário ler e acessar as propriedades correspondentes usando as bibliotecas de leitura/gravação de arquivos correspondentes em seus aplicativos.

Restrições

  • Um aplicativo deve ter uma implantação de produção. A API bloqueia a exclusão de uma implantação de produção. Você deve trocar uma implantação por preparo antes de excluí-la.
  • Um aplicativo pode ter no máximo duas implantações. A API bloqueia a criação de mais de duas implantações. Implante o novo binário na implantação de produção ou de preparação existente.
  • O gerenciamento de implantação não está disponível no plano Básico. Use o plano Standard ou Enterprise para o recurso de implantação azul-verde.

Próximas etapas