Free Tier: Configurar o Helidon em uma Instância do Ubuntu

Neste tutorial, você usa uma conta do Oracle Cloud Infrastructure Free Tier para configurar uma instância de computação do Ubuntu. Em seguida, você configura um servidor Helidon MicroProfile (MP) para seu host.

As principais tarefas incluem:

  • Configure um compartimento para seu trabalho de desenvolvimento.
  • Instale a sua instância do Ubuntu Linux e conecte-a à sua VCN (Virtual Cloud Network).
    • Configure uma rede virtual na nuvem do Oracle Cloud Infrastructure e serviços de rede relacionados necessários para que seu host se conecte à internet.
    • Configure as chaves de criptografia ssh para acessar seu Ubuntu Linux Server.
  • Configure regras de entrada para sua VCN.
  • Instale o JDK e o Maven.
  • Configure o Helidon com o servidor MicroProfile (MP).
  • Crie um aplicativo Java Hello World.
  • Teste seu aplicativo.

Este é um diagrama simplificado da configuração da sua Instância do Linux.

Um diagrama dos componentes necessários para executar um servidor Helidon MicroProfile no Oracle Cloud Infrastructure

Para obter informações adicionais, consulte:

Antes de Começar

Para concluir este tutorial com sucesso, você deve ter o seguinte:

Requisitos

1. Configurar um Compartimento para Desenvolvimento

Configure um compartimento para seu desenvolvimento.

Criar um Compartimento

Crie um compartimento para os recursos criados neste tutorial.

  1. Acesse a Console do Oracle Cloud Infrastructure .
  2. Abra o menu de navegação e clique em Identidade e Segurança. Em Identidade, clique em Compartimentos.
  3. Clique em Criar Compartimento.
  4. Preencha as informações a seguir:
    • Nome: <your-compartment-name>
    • Descrição Compartment for <your-description>.
    • Compartimento Principal: <your-tenancy>(root)
  5. Clique em Criar Compartimento.

Referência: Criar um compartimento

2. Instalar uma Instância do Ubuntu Linux

Use o workflow Criar uma Instância de VM para criar uma nova instância de computação.

O workflow faz várias coisas ao instalar a instância:

  • Cria e instala uma instância de computação que executa o Ubuntu Linux.
  • Cria uma VCN com a sub-rede obrigatória e os componentes necessários para conectar a instância do Ubuntu Linux à internet.
  • Cria um par de chaves ssh que você usa para se conectar à instância.
Verificar Etapas de Instalação

Para começar a instalar uma instância com o workflow Criar uma instância de VM, siga estas etapas:

Importante

As etapas fornecidas são para uma conta Free Tier. Se você estiver usando uma conta paga, as etapas poderão ser diferentes das mostradas aqui.
  1. Clique no ícone do Oracle Cloud para ir à página de destino principal.
    • Role para baixo até Ativar Recursos.
    • Selecione o workflow Criar uma instância de VM.
    A página Criar instância de computação é exibida. As seções da página incluem
    • Nome e Compartimento
    • Classificação
    • Segurança
    • Imagem e forma
    • Rede
    • Adicionar chaves SSH
    • Volume de inicialização
  2. Escolha o Name e o Compartment.

    Opções Iniciais

    • Nome: <name-for-the-instance>
    • Criar no compartimento: <your-compartment-name>

    Insira um valor para o nome ou use o padrão fornecido pelo sistema. Para o compartimento, selecione o compartimento criado

  3. Verifique as configurações de Colocação.
    • Use os valores padrão. Um domínio de disponibilidade é designado para você.

    Os dados podem ser semelhantes aos seguintes:

    Domínio de disponibilidade

    • Domínio de disponibilidade: AD-1
    • Tipo de capacidade: Capacidade sob demanda
    • Domínio de falha: Permitir que a Oracle escolha o melhor domínio de falha
    Observação

    Para Free Tier, use a opção Always Free Elegível para o domínio de disponibilidade.
  4. Verifique as definições de Segurança.
    • Execute as configurações padrão.

    Os dados podem ser semelhantes aos seguintes:

    Segurança

    • Instância protegida: Desativada
    • Cálculo confidencial: Desativado
  5. Revise as definições de Imagem e forma. Altere a imagem do sistema operacional.
    • Clique em Editar.
    • Clique em Alterar Imagem.
    • Clique em Ubuntu.
    • Selecione Ubuntu Canônico 22.04 ou uma versão posterior.
    • Clique em Selecionar Imagem.
    Observação

    A seguir estão amostras de dados de uma máquina virtual AMD. Os valores reais podem ser distintos.

    Imagem e forma

    • Imagem: Ubuntu 22.04 Canônico
    • Produção de imagem: <current-build-date>
    • Forma: VM.Standard.E2.1.Micro
    • OCPU: 1
    • Memória (GB): 1
    • Largura de Banda da rede (Gbps): 0.48
    Observação

    Para Free Tier, use as opções de forma Always Free Elegíveis.
    • Prosseguir para a próxima sessão.
  6. Verifique as configurações de Rede. Faça as seguintes alterações no padrão.
    • Clique em Editar.
    • Rede Principal: Selecione Criar nova rede virtual na nuvem.
    • Novo nome da rede virtual na nuvem: Crie o nome da VCN gerada ou forneça um nome.
    • Criar no compartimento: <your-compartment-name>.
    • Sub-rede: Selecione Criar nova sub-rede pública.
    • Novo nome de sub-rede: Crie o nome da sub-rede gerada ou forneça um nome.
    • Criar no compartimento: <your-compartment-name>.
    • Bloco CIDR: Obtenha o valor padrão (10.0.0.0/24, por exemplo).
    • Endereço IPv4 público, obtenha o valor padrão de Designar um endereço IPv4 público.
    • Prosseguir para a próxima sessão.
  7. Verifique as definições de Adicionar chaves SSH. Utilize os valores padrão fornecidos pelo workflow.
    • Selecione a opção Gerar um par de chaves para mim.
    • Clique em Salvar Chave Privada e em Salvar Chave Pública para salvar as chaves SSH públicas e privadas desta instância de computação.

    Se você quiser usar suas próprias chaves SSH, selecione uma das opções para fornecer sua chave pública.

    Observação

    Coloque seus arquivos de chave privada e pública em um local seguro. Não será possível recuperar chaves novamente após a criação da instância de computação.
  8. Revise as definições de Volume de inicialização.

    Desmarque a definição Especificar um tamanho de volume de inicialização do cliente.

    Marque a definição Usar criptografia em trânsito.

    Desmarque a definição Crie este volume com uma chave gerenciada por você.

  9. Clique em Criar para criar a instância. O provisionamento do sistema poderá levar alguns minutos.
Você criou com sucesso uma instância do Ubuntu Linux.

3. Ativar Acesso à Internet

O assistente de Criação de uma Instância de VM cria automaticamente uma VCN para sua VM. Você adiciona uma regra de entrada à sua sub-rede para permitir conexões com a internet na porta 8080.

Criar uma Regra de Entrada para a sua VCN

Siga estas etapas para selecionar a sub-rede pública da sua VCN e adicionar a regra de entrada.

  1. Abra o menu de navegação e clique em Networking. Em seguida, clique em Virtual Cloud Networks.
  2. Selecione a VCN que você criou com sua instância de computação.
  3. Com sua nova VCN exibida, clique no link de sub-rede <your-subnet-name>.

    As informações da sub-rede pública são exibidas com as Listas de Segurança na parte inferior da página. Um link para a Lista de Segurança Padrão da sua VCN é exibido.

  4. Clique no link Lista de Segurança Padrão.

    As Regras de Entrada padrão da sua VCN são exibidas.

  5. Clique em Adicionar Regras de Entrada.

    Uma caixa de diálogo Adicionar Regras de Entrada é exibida.

  6. Preencha a regra de entrada com as informações a seguir.

    Preencha a regra de entrada da seguinte forma:

    • Sem monitoramento de estado: Marcado
    • Tipo de Origem: CIDR
    • CIDR de Origem: 0.0.0.0/0
    • Protocolo IP: TCP
    • Intervalo de portas de origem: (leave-blank)
    • Faixa de Portas de Destino: 8080
    • Descrição: Permitir conexões HTTP

    Clique em Adicionar Regra de Entrada. Agora são permitidas conexões HTTP. Sua VCN está configurada para o servidor Apache.

  7. Clique em Adicionar Regras de Entrada.
    Agora são permitidas conexões HTTP. Sua VCN está configurada para o servidor Apache.
Você criou com sucesso uma regra de entrada que disponibiliza sua instância pela internet.

4. Executar um Aplicativo no Servidor Helidon

Em seguida, configure o Helidon na sua instância do Ubuntu Linux.

Configurar o Firewall do Ubuntu

Para configurar o firewall do Ubuntu, siga estas etapas:

  1. Abra o menu de navegação e clique em Compute. Em Compute, clique em Instâncias.
  2. Clique no link para a instância criada na etapa anterior.

    Na página Detalhes da Instância, procure na seção VNIC Principal. Copie o endereço IP público que o sistema criou para você. Você usa esse endereço IP para se conectar à sua instância.

  3. Abra uma janela Terminal ou Prompt de Comando.
  4. Passe para o diretório no qual você armazenou as chaves de criptografia ssh criadas na parte 2.
  5. Conecte-se à sua instância com este comando SSH.
    ssh -i <your-private-key-file> ubuntu@<x.x.x.x>

    Como você identificou sua chave pública quando criou a instância, esse comando o registrará em sua instância. Agora você pode executar comandos sudo para instalar e iniciar seu servidor.

  6. Atualize as definições do firewall.

    Por padrão, o firewall do Ubuntu está desativado. No entanto, você deve atualizar sua configuração iptables para permitir o tráfego HTTP. Execute os comandos a seguir:

    iptables.
    sudo iptables -I INPUT 6 -m state --state NEW -p tcp --dport 8080 -j ACCEPT
    sudo netfilter-persistent save

    Os comandos adicionam uma regra para permitir o tráfego HTTP por meio da porta 8080 e salva as alterações nos arquivos de configuração iptables.

Instalar OpenJDK
  1. Execute os comandos a seguir:
    sudo apt update
    sudo apt -y install openjdk-11-jdk-headless
    java -version
  2. Defina JAVA_HOME em .bashrc.

    Atualize o arquivo:

    vi .bashrc

    No arquivo, anexe o seguinte texto e salve o arquivo:

    # set JAVA_HOME
    export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
  3. Ative o comando anterior na janela atual.
    source ~/.bashrc
Instalar Apache Maven

Execute os comandos a seguir:

  1. Instale o Maven.
    sudo apt -y install maven
  2. Verifique a instalação do Maven.
    mvn --version
Instalar Helidon

Execute o seguinte Archetype Maven que cria um modelo de projeto Maven com o qual começar. Este projeto usa o exemplo de Início Rápido do Helidon MP no site do Helidon. Execute os comandos a seguir:

  1. Execute a instalação do Helidon Maven. Por exemplo:
    mvn -U archetype:generate -DinteractiveMode=false \
        -DarchetypeGroupId=io.helidon.archetypes \
        -DarchetypeArtifactId=helidon-quickstart-mp \
        -DarchetypeVersion=2.2.1 \
        -DgroupId=io.helidon.examples \
        -DartifactId=helidon-quickstart-mp \
        -Dpackage=io.helidon.examples.quickstart.mp

    O Archetype cria um projeto Maven no diretório atual. Sua saída é semelhante à seguinte:

    [INFO] Project created from Archetype in dir: /home/ubuntu/helidon-quickstart-mp
    [INFO] BUILD SUCCESS
    Observação

    Para instalar a versão mais recente do Helidon MP, consulte Helidon MP Quickstart
  2. Passe para o diretório helidon-quickstart-mp.
    cd helidon-quickstart-mp
  3. Crie o aplicativo.
    mvn package

    Você recebe uma mensagem de sucesso.

    [INFO] BUILD SUCCESS
  4. Execute o aplicativo.
    java -jar target/helidon-quickstart-mp.jar
Testar seu Aplicativo Helidon

Agora você pode testar seu aplicativo.

  1. Em um novo terminal, conecte-se à sua instância do Ubuntu com suas chaves SSH e, em seguida, na linha de comando, digite:
    curl -X GET http://localhost:8080/greet

    Como alternativa, você pode conectar seu browser ao endereço IP público designado à sua instância: http://<x.x.x.x>:8080/greet

    Você vê {"message":"Hello World!"} na sua instância ou no seu browser.

  2. Digite um nome para a saudação. No terminal, digite:
    curl -X GET http://localhost:8080/greet/Mike

    Ou, no seu browser, digite: http://<x.x.x.x.x.x.x>:8080/greet/Mike.

    Você vê {"message":"Hello Mike!"} na sua instância ou no seu browser.

  3. Atualize a saudação. No terminal, digite:
    curl -X PUT -H "Content-Type: application/json" -d '{"greeting" : "Aloha"}' http://localhost:8080/greet/greeting

    O comando atualiza o Hello na mensagem para Aloha.

  4. Teste a saudação atualizada. No browser, digite: http://<x.x.x>:8080/greet/Mike.

    Você vê {"message":"Aloha Mike!"} na sua instância ou no seu browser.

  5. Digite os comandos a seguir no browser para obter a integridade e as métricas.
    http://<x.x.x.x>:8080/health
    http://<x.x.x.x>:8080/metrics

    Para obter métricas em JSON, no terminal, digite:

    curl -H 'Accept: application/json' -X GET http://localhost:8080/metrics

Parabéns! Você criou com sucesso um aplicativo Hello World usando o serviço Helidon MicroProfile, na sua instância do Oracle Cloud Infrastructure.

Referências:

Para obter informações detalhadas sobre este exemplo, consulte Helidon MP Quickstart

O Que Vem a Seguir

Você criou com sucesso um aplicativo Hello World usando o serviço Helidon MicroProfile, na sua instância do Oracle Cloud Infrastructure.

Para explorar mais informações sobre desenvolvimento com produtos Oracle, confira estes sites: