Instale o teste da plataforma do ABAP 2022 no Google Cloud Platform e instale o SDK do ABAP

1. Introdução

Neste codelab, listamos as etapas para instalar o teste da plataforma ABAP de 2022 no Google Cloud e depois instalar o SDK do ABAP para o Google Cloud.

Usamos os scripts hospedados neste repositório do GitHub. O arquivo README do repositório tem uma documentação detalhada da funcionalidade do script.

Os seguintes serviços do Google Cloud são usados neste codelab:

• Compute Engine
• Serviços de rede
• Cloud Shell

O que você vai criar

Você criará o seguinte usando o script:

• Uma instância do Compute Engine com o teste da plataforma ABAP 2022 em execução no contêiner do Docker.
• regras de firewall.
• Conta de serviço para acessar as APIs do Google Cloud usando o SDK do ABAP para o Google Cloud.

2. Requisitos

• Um navegador, como o Chrome ou o Firefox
• Um projeto do Google Cloud com faturamento ativado ou crie uma conta de teste sem custo financeiro de 90 dias no Google Cloud Platform.
• GUI do SAP (Windows ou Java) instalada no sistema. Se a GUI do SAP já estiver instalada no seu laptop, conecte-se ao SAP usando o endereço IP externo da VM como o IP do servidor de aplicativos. No Mac, você também pode instalar a GUI do SAP para Java, disponível neste link.

3. Antes de começar

1. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud (por exemplo: abap-sdk-poc).
2. Verifique se o faturamento está ativado para seu projeto do Cloud. Saiba como verificar se o faturamento está ativado em um projeto. Pule esta etapa se você estiver usando a conta de teste sem custo financeiro de 90 dias.
3. Você vai usar o Cloud Shell, um ambiente de linha de comando em execução no Google Cloud.
4. No console do Cloud, clique em Ativar o Cloud Shell no canto superior direito:

5. Execute os comandos a seguir para autenticar sua conta e definir o projeto padrão como abap-sdk-poc. A zona us-west4-b é usada como exemplo. Se necessário, altere o projeto e a zona nos comandos a seguir de acordo com sua preferência. Esses parâmetros são usados pelo script de instalação.

gcloud auth login
gcloud config set project abap-sdk-poc
gcloud config set compute/zone us-west4-b

4. Executar o script de criação

• Use o seguinte comando para executar o script create_vm_withdocker.sh.

mkdir sap-docker-2022
git clone https://github.com/google-cloud-abap/abap-cloud-trial-2022-gcp.git
chmod 755 create_vm_with_docker.sh
cd abap-cloud-trial-2022-gcp
./create_vm_with_docker.sh

O script realizará as seguintes atividades:

• Crie uma VM (nome: abap-trial-docker, configuração: n2-highmem-4, SO e disco: debian-12-bookworm-v20240815, 200gb).
• Instale a versão mais recente do mecanismo do Docker.
• Extraia e inicie o contêiner docker do teste da plataforma ABAP 2022.
• Ative o Serviço de credenciais da conta de serviço do IAM e o Serviço de validação de endereço, que serão usados para avaliar o SDK do ABAP nos próximos laboratórios de códigos.
• Crie uma conta de serviço [e-mail],para usar pelo SDK do ABAP.

Observação: o script vai concordar automaticamente com os termos de licença da SAP em nome do executor usando a sinalização:

agree-to-sap-license. (Consulte a seção de licença na página de hub do Docker para mais detalhes sobre a licença)

5. Monitore a instalação

A VM será criada em alguns minutos, mas a instalação da etapa do contêiner do Docker do SAP levará cerca de 15 minutos.

Para monitorar o processo de instalação, siga estas etapas:

1. Depois que a VM for criada, use um dos seguintes métodos para se conectar via SSH ao sistema:

• Clique no botão SSH no Console do Cloud.

• Execute o seguinte comando no terminal do Cloud Shell:

gcloud compute ssh "abap-trial-docker"

2. O script de instalação cria um arquivo de saída /tmp/output.txt. Para monitorar o processo de instalação, execute o comando tail com esse arquivo.

tail -f /tmp/output.txt

3. Aguarde até a mensagem de confirmação abaixo aparecer no arquivo de saída informando que o contêiner do Docker do SAP está em execução.

Você também pode executar o seguinte comando para verificar se o contêiner está em execução:

sudo docker ps

A instalação foi concluída, e agora podemos prosseguir para a próxima etapa de conexão com o sistema.

6. Testar a conexão com o sistema SAP

Agora é possível se conectar ao sistema SAP.

• Execute o comando a seguir para saber o endereço IP externo da VM ou verifique no console do Google Cloud.

gcloud compute instances describe abap-trial-docker  \
--format='get(networkInterfaces[0].accessConfigs[0].natIP)'

Use as seguintes informações para se conectar usando a GUI do SAP:

• ID do sistema: A4H
• Número da instância: 00
• Servidor de aplicativos: <External IP Address>

O nome de usuário é DEVELOPER com a senha ABAPtr2022#00. Isso também é predefinido (mesma senha) para o cliente 000, cliente 001: SAP*, DDIC. Consulte este link para mais detalhes.

7. Renovar a licença de teste da SAP

Para renovar a licença de avaliação da SAP, siga estas etapas:

1. Faça login no sistema usando as seguintes credenciais:

Cliente:	001
User-ID:	SAP*
Senha:	ABAPtr2022#00

2. Encontre a chave de hardware no Tcode: SLICENSE

3. Gere uma nova chave de licença no site Chaves de licença SAP para versões de visualização, avaliação e desenvolvedor. Selecione a A4H do sistema, atualize os dados pessoais, as informações do sistema com a chave de hardware e concorde com a licença. Clique no botão Generate para criar o arquivo de chave de licença A4H_Multiple.txt.

4. Instale a nova chave de licença usando o Tcode: SLICENSE

• Acesse Tcode: SLICENSE, clique no botão Install e selecione o documento de texto transferido por download A4H_Multiple.txt. O sistema será estendido por mais três meses.

8. Ativar a configuração do TMS

Para importar transportes para o sistema, é necessário ativar a configuração do TMS.

1. Faça login no sistema usando o nome de usuário DEVELOPER com a senha Htods70334.
2. Acesse o TCode STMS > Visão geral > Importações.

3. Selecione Ambiente > Visão geral do sistema.

4. Selecione Extras > Distribuir e ativar a configuração.

5. Acesse o TCode STMS_IMPORT e você verá a seguinte tela:

Agora, o sistema SAP está pronto para importar qualquer transporte.

9. Configurar certificado de confiança

Para se conectar com segurança às APIs do Google usando o SDK do ABAP, é preciso usar certificados de confiança.

1. Faça o download dos seguintes certificados do repositório do Google Trust Services para o seu computador:

• GTS raiz R1 (PEM)
• GTS CA 1C3 (PEM)

2. Na GUI do SAP, use a transação STRUST para importar o certificado raiz e o certificado subordinado para a pasta PSE do cliente SSL (Standard) do cliente SSL.
3. Em STRUST, selecione o cliente SSL do cliente SSL do nó (padrão) e clique em "Importar certificado" para fazer upload dos dois arquivos. Clique em Adicionar à lista de certificados e Salvar.

10. Importe o SDK do ABAP para a versão mais recente do Google Cloud

Os arquivos de transporte do SDK do ABAP para o Google Cloud estão disponíveis neste link. Para acelerar, executaremos a importação usando um script.

1. No Cloud Shell, use SSH para se conectar à VM do Docker SAP:

gcloud compute ssh "abap-trial-docker-2022"

2. Faça o download e execute o script de transporte de importação:

wget https://raw.githubusercontent.com/google-cloud-abap/abap-cloud-trial-2022-gcp/main/import_abap_sdk.sh
chmod 755 import_abap_sdk.sh
./import_abap_sdk.sh

3. Quando terminar, procure o pacote /GOOG/ABAP_SDK em SE80. Agora você tem o SDK do ABAP instalado.

11. Criar um exemplo de programa ABAP usando o SDK do ABAP

Vamos criar um exemplo de programa ABAP para usar o serviço de validação de endereço para corrigir um endereço. Siga o codelab - Configurar a autenticação do SDK do ABAP usando tokens para SAP hospedados na VM do Compute Engine.

12. Parabéns

Parabéns! Você instalou o teste da plataforma do ABAP em 2022 no Google Cloud Platform e importou os transportes para o SDK do ABAP para o Google Cloud.

O sistema de teste da SAP permitirá que você saiba mais sobre o SDK do ABAP.

Prossiga com os outros codelabs do SDK do ABAP para continuar sua jornada de aprendizado sobre como usar o SDK do ABAP para o Google Cloud e acessar vários serviços do Google Cloud.

13. Limpar

Caso não queira continuar com outros codelabs relacionados ao SDK do ABAP para Google Cloud, faça a limpeza.

Excluir o projeto

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto atual para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos nele.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um ID do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua os recursos selecionados dentro do projeto em vez de excluir o projeto inteiro.

Se você planeja explorar várias arquiteturas, tutoriais e guias de início rápido, a reutilização de projetos pode evitar que você exceda limites da cota.

• Exclua o projeto do Google Cloud:

gcloud projects delete abap-sdk-poc

Excluir recursos individuais

1. Exclua a instância de computação:

gcloud compute instances delete abap-trial-docker

2. Exclua as regras de firewall:

gcloud compute firewall-rules delete sapmachine

3. Exclua a conta de serviço:

gcloud iam service-accounts delete \
    [e-mail]