Ao implantar uma aplicação no console do SAE, o SAE usa parâmetros de inicialização predefinidos para iniciar o contêiner. Personalize o comando de inicialização para aplicar configurações específicas, como as do Nginx, ou substituir os parâmetros padrão de inicialização.
Pontos de entrada
O procedimento varia conforme o cenário.
Criar uma aplicação
Faça login no console do SAE. No painel de navegação à esquerda, escolha Applications > Applications. Selecione a região e o namespace desejados e clique em Create Application.
Na página do assistente Basic Information, configure as definições necessárias e clique em Next: Advanced Settings.
Modificar uma aplicação em execução
A reimplantação de uma aplicação reinicia o serviço. Para evitar erros imprevisíveis, como interrupções de negócio, recomendamos implantar aplicações fora dos horários de pico.
Faça login no console do SAE. No painel de navegação à esquerda, escolha Applications > Application List. Selecione a região e o namespace desejados e clique no nome da aplicação alvo.
Na página Basic Information da aplicação alvo, clique em Deploy Application.
Modificar uma aplicação parada
Faça login no console do SAE. No painel de navegação à esquerda, escolha Applications > Application List. Selecione a região e o namespace desejados e clique no nome da aplicação alvo.
Na página Basic Information da aplicação alvo, clique em Modify Application Configurations.
Defina o comando de inicialização da aplicação
Imagem
Geralmente, não é necessário definir um comando de inicialização. A instrução ENTRYPOINT ou CMD no Dockerfile já define o comando de inicialização do contêiner.
Por exemplo, o seguinte comando do Dockerfile executa quando o contêiner inicia.
ENTRYPOINT [nginx, '-g', 'daemon off;'] Para substituir o comando de inicialização configurado no Dockerfile, siga estas etapas:
Na seção Startup Command, selecione um interpretador de scripts, como >_ /bin/sh ou >_ /bin/bash. Certifique-se de que o interpretador escolhido exista na sua imagem.
-
Configure o comando de inicialização do contêiner. O formato é o seguinte:
-
>_ /bin/sh
sh -c 'while true; do echo hello; sleep 10;done' -
>_ /bin/bash
bash -c 'while true; do echo hello; sleep 10;done'
-
Se você não estiver familiarizado com as configurações ENTRYPOINT e CMD no Dockerfile original, não personalize o comando de inicialização nem seus parâmetros. Um comando inválido causa falha na criação da aplicação.
Pacote JAR
Iniciar uma aplicação Java exige um comando de inicialização e parâmetros, como parâmetros da JVM e políticas de GC.
O SAE compila automaticamente o pacote JAR enviado em uma imagem e o executa como um contêiner com um comando de inicialização interno, parâmetros e caminho do pacote JAR. Use o console do SAE para modificar o comando e os parâmetros de inicialização padrão.
Na seção Startup Command Settings, insira as configurações necessárias. Veja abaixo um exemplo de comando de inicialização.
O comando de inicialização padrão é $JAVA_HOME/bin/java $Options -jar $CATALINA_OPTS "$package_path" $args.
|
Parâmetro |
Descrição |
|
Default Startup Command |
O comando de inicialização padrão fornecido pelo SAE. |
|
Options Settings |
Configure os parâmetros da JVM. Para mais informações, consulte JVM parameter configuration notes, Tuning Java Virtual Machines e JVM Tuning: How to Prepare Your Environment for Performance Tuning. Para ativar a depuração remota na sua aplicação, adicione o comando correspondente à sua versão do JDK.
Os parâmetros são:
Importante Os comandos de inicialização para aplicações implantadas a partir de pacotes WAR e JAR são diferentes. Não os utilize indistintamente. O comando de depuração remota neste exemplo aplica-se a ambos os métodos de implantação. |
|
args Settings |
Configure o comando para redirecionar a saída padrão e o erro padrão, como |
Pacote WAR
Na seção Startup Command Settings, insira as configurações necessárias. Veja abaixo um exemplo de comando de inicialização.
O comando de inicialização padrão é CATALINA_OPTS="$CATALINA_OPTS $Options" catalina.sh run, onde $Options é um espaço reservado para os parâmetros da JVM especificados na seção Options Settings. Para evitar OOM, recomendamos definir a memória heap com um valor inferior à memória total da instância e reservar 1 GB de espaço. Para mais informações, consulte as melhores práticas de configuração da JVM.
|
Parâmetro |
Descrição |
|
Default Startup Command |
O comando de inicialização padrão fornecido pelo SAE. |
|
Options Settings |
Configure os parâmetros da JVM. Para mais informações, consulte JVM parameter configuration notes, Tuning Java Virtual Machines e JVM Tuning: How to Prepare Your Environment for Performance Tuning. Para ativar a depuração remota na sua aplicação, adicione o comando correspondente à sua versão do JDK.
Os parâmetros são:
Importante Os comandos de inicialização para aplicações implantadas a partir de pacotes WAR e JAR são diferentes. Não os utilize indistintamente. O comando de depuração remota neste exemplo aplica-se a ambos os métodos de implantação. |
Pacote ZIP
Na seção Startup Command, selecione um interpretador de scripts e configure o comando de inicialização do contêiner.
-
>_ /bin/sh
sh -c 'gunicorn -w 3 -b 0.0.0.0:8080 app.hello:app' -
>_ /bin/bash
bash -c 'gunicorn -w 3 -b 0.0.0.0:8080 app.hello:app'