Instala la versión de prueba de 2022 de la plataforma ABAP en Google Cloud Platform e instala el SDK de ABAP

1. Introducción

En este codelab, enumeramos los pasos para instalar la prueba ABAP Platform 2022 en Google Cloud y, luego, instalar el SDK de ABAP para Google Cloud.

Usamos las secuencias de comandos que se alojan en este repositorio de GitHub. El archivo README del repositorio tiene documentación detallada de la funcionalidad de la secuencia de comandos.

En este codelab, se usan los siguientes servicios de Google Cloud:

• Compute Engine
• Servicios de red
• Cloud Shell

Qué compilarás

Con la secuencia de comandos, crearás lo siguiente:

• Una instancia de Compute Engine con la prueba de la plataforma ABAP de 2022 que se ejecuta en el contenedor de Docker.
• Reglas de firewall.
• Cuenta de servicio para acceder a las APIs de Google Cloud con el SDK de ABAP para Google Cloud.

2. Requisitos

• Un navegador, como Chrome o Firefox
• Tener un proyecto de Google Cloud con facturación habilitada o crear una cuenta de prueba gratuita de 90 días para Google Cloud Platform
• GUI de SAP (Windows o Java) instalada en tu sistema Si la GUI de SAP ya está instalada en tu laptop, conéctate a SAP con la dirección IP externa de la VM como la IP del servidor de aplicaciones. Si utilizas una Mac, también puedes instalar la GUI de SAP para Java disponible en este vínculo.

3. Antes de comenzar

1. En la consola de Google Cloud, en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud (por ejemplo: abap-sdk-poc).
2. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto. Omite este paso si usas la cuenta de prueba gratuita de 90 días.
3. Usarás Cloud Shell, un entorno de línea de comandos que se ejecuta en Google Cloud.
4. En la consola de Cloud, haz clic en Activar Cloud Shell en la esquina superior derecha:

5. Ejecuta los siguientes comandos para autenticar tu cuenta y establece el proyecto predeterminado como abap-sdk-poc. Se usa la zona us-west4-b como ejemplo. Si es necesario, cambia el proyecto y la zona en los siguientes comandos según tus preferencias. La secuencia de comandos de instalación utiliza estos parámetros.

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

4. Ejecuta la secuencia de comandos de creación

• Ejecuta el siguiente comando para ejecutar la secuencia de comandos 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

La secuencia de comandos realizará las siguientes actividades:

• Crea una VM (nombre: abap-trial-docker, configuración: n2-highmem-4, SO y disco: debian-12-bookworm-v20240815, 200gb).
• Instala la versión más reciente del motor de Docker.
• Extrae y, luego, inicia el contenedor de docker de la prueba de la plataforma ABAP 2022.
• Activa el Servicio de credenciales de la cuenta de servicio de IAM y el Servicio de validación de direcciones, que usamos para evaluar el SDK de ABAP en los siguientes codelabs.
• Crea una cuenta de servicio [e-mail], que usará el SDK de ABAP.

Nota: La secuencia de comandos aceptará automáticamente los términos de la licencia de SAP en nombre del ejecutor que usa la marca.

agree-to-sap-license. (Consulta la sección de licencias en la página de Docker Hub para obtener más detalles sobre la licencia).

5. Supervisa la instalación

La VM se creará en unos minutos, pero el paso del contenedor de SAP de Docker tardará unos 15 minutos.

Para supervisar el proceso de instalación, sigue estos pasos:

1. Después de crear la VM, usa uno de los siguientes métodos para establecer una conexión SSH al sistema:

• Haz clic en el botón SSH en la consola de Cloud.

• Ejecuta el siguiente comando en la terminal de Cloud Shell:

gcloud compute ssh "abap-trial-docker"

2. La secuencia de comandos de instalación crea un archivo de salida /tmp/output.txt. Para supervisar el proceso de instalación, ejecuta el comando tail con este archivo.

tail -f /tmp/output.txt

3. Espera hasta ver el siguiente mensaje de confirmación en el archivo de salida que indica que se está ejecutando el contenedor de Docker de SAP.

También puedes ejecutar el siguiente comando para comprobar si se está ejecutando el contenedor:

sudo docker ps

Esto completa la instalación y ahora podemos continuar con el siguiente paso para conectarnos al sistema.

6. Prueba la conexión al sistema SAP

Ahora puedes conectarte al sistema SAP.

• Ejecuta el siguiente comando para obtener la dirección IP externa de la VM o verifícala en la consola de Google Cloud.

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

Usa la siguiente información para conectarte desde la GUI de SAP:

• ID del sistema: A4H
• Número de instancia: 00
• Servidor de aplicaciones: <Dirección IP externa>

El nombre de usuario es DEVELOPER y la contraseña ABAPtr2022#00. Esta también está predefinida (misma contraseña) para el cliente 000, cliente 001: SAP*, DDIC. Consulta aquí para obtener más detalles.

7. Renovar la licencia de prueba de SAP

Para renovar la licencia de prueba de SAP, sigue estos pasos:

1. Accede al sistema con las siguientes credenciales:

Cliente:	001
ID de usuario:	SAP*
Contraseña:	ABAPtr2022#00

2. Obtén la clave de hardware de Tcode: SLICENSE

3. Genera una clave de licencia nueva desde el sitio SAP License Keys for Preview, Evaluation and Developer Versions (Claves de licencia de SAP para versiones preliminares, evaluaciones y para desarrolladores). Selecciona el sistema A4H, actualiza los datos personales y la información del sistema con una clave de hardware, y acepta la licencia. Haz clic en el botón Generar para crear el archivo de claves de licencia A4H_Multiple.txt.

4. Instala la nueva clave de licencia con Tcode: SLICENSE

• Ve a Tcode: SLICENSE, haz clic en el botón Instalar y selecciona el documento de texto descargado A4H_Multiple.txt. El sistema se extenderá por otros 3 meses.

8. Activa la configuración de TMS

Para importar transportes al sistema, debemos activar la configuración de TMS.

1. Accede al sistema con el nombre de usuario DEVELOPER y la contraseña Htods70334.
2. Ve a TCode STMS > Descripción general > Importaciones.

3. Selecciona Entorno > Descripción general del sistema

4. Selecciona Contenido adicional > Distribuye y activa la configuración.

5. Ve a TCode STMS_IMPORT, donde deberías ver la siguiente pantalla:

Ahora, el sistema SAP está listo para importar cualquier transporte.

9. Configurar certificado de confianza

Para conectarse de forma segura a las APIs de Google con el SDK de ABAP, se requieren certificados de confianza.

1. Descarga los siguientes certificados del repositorio de Google Trust Services en tu computadora:

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

2. En la GUI de SAP, usa la transacción STRUST para importar el certificado raíz y el subordinado a la carpeta de PSE del cliente SSL (estándar) del cliente SSL.
3. En STRUST, selecciona el nodo SSL del cliente SSL (estándar) y haz clic en Importar certificado para subir ambos archivos. Luego, haz clic en Agregar a la lista de certificados y en Guardar.

10. Importa la versión más reciente del SDK de ABAP para Google Cloud

Los archivos de transporte del SDK de ABAP para Google Cloud están disponibles en este vínculo. Para acelerar, ejecutaremos la importación utilizando una secuencia de comandos.

1. Desde Cloud Shell, establece una conexión SSH a la VM de Docker de SAP:

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

2. Descarga y ejecuta la secuencia de comandos de importación de transporte:

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. Cuando se haya completado, busca el paquete /GOOG/ABAP_SDK en SE80. Ahora tienes instalado el SDK de ABAP.

11. Escribe un programa ABAP de muestra con el SDK de ABAP

Escribamos un ejemplo del programa ABAP para usar el servicio de Address Validation con el objetivo de corregir una dirección. Sigue el codelab Cómo configurar la autenticación del SDK de ABAP con tokens para SAP alojados en la VM de Compute Engine.

12. ¡Felicitaciones!

¡Felicitaciones! Instalaste correctamente la prueba de 2022 de la plataforma ABAP en Google Cloud Platform y, luego, importaste los transportes del SDK de ABAP para Google Cloud.

El sistema de prueba de SAP te permitirá explorar más sobre el SDK de ABAP.

Ahora puedes continuar con los otros codelabs del SDK de ABAP para continuar con tu recorrido de aprendizaje sobre el uso del SDK de ABAP para Google Cloud y acceder a varios servicios de Google Cloud.

13. Limpia

Si no quieres continuar con los codelabs adicionales relacionados con el SDK de ABAP para Google Cloud, continúa con la limpieza.

Borra el proyecto

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

• Se borra todo en el proyecto. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL de appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varios instructivos, arquitecturas o guías de inicio rápido, la reutilización de proyectos puede ayudarte a no exceder los límites de las cuotas de proyectos.

• Borra el proyecto de Google Cloud:

gcloud projects delete abap-sdk-poc

Borra recursos individuales

1. Borra la instancia de procesamiento:

gcloud compute instances delete abap-trial-docker

2. Borra las reglas de firewall:

gcloud compute firewall-rules delete sapmachine

3. Borra la cuenta de servicio:

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