1. Introducción
En este codelab, se enumeran los pasos para instalar ABAP Platform Trial 2022 en Google Cloud y, luego, instalar el SDK de ABAP para Google Cloud.
Usamos las secuencias de comandos alojadas en este repositorio de GitHub. El archivo README del repositorio tiene documentación detallada sobre 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 versión de prueba de ABAP Platform 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
- Un proyecto de Google Cloud con la facturación habilitada o crea una cuenta de prueba gratuita de 90 días para Google Cloud Platform.
- La GUI de SAP (Windows o Java) instalada en tu sistema Si SAP GUI ya está instalado en tu laptop, conéctate a SAP con la dirección IP externa de la VM como la IP del servidor de aplicaciones. Si usas Mac, también puedes instalar la GUI de SAP para Java disponible en este vínculo.
3. Antes de comenzar
- En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud (por ejemplo,
abap-sdk-poc).
- 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.
- Usarás Cloud Shell, un entorno de línea de comandos que se ejecuta en Google Cloud.
- En la consola de Cloud, haz clic en Activar Cloud Shell en la esquina superior derecha:
- Ejecuta los siguientes comandos para autenticar tu cuenta y establecer el proyecto predeterminado en
abap-sdk-poc
. La zonaus-west4-b
se usa como ejemplo. Si es necesario, cambia el proyecto y la zona en los siguientes comandos según tus preferencias. Estos parámetros se usan en la secuencia de comandos de instalación.
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
cd sap-docker-2022
git clone https://github.com/google-cloud-abap/abap-cloud-trial-2022-gcp.git
cd abap-cloud-trial-2022-gcp
chmod 755 create_vm_with_docker.sh
./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 de Docker Engine.
- Extrae e inicia el contenedor de Docker de la versión de prueba de ABAP Platform 2022.
- Activa el servicio de credenciales de la cuenta de servicio de IAM y el servicio de Address Validation, que usamos para evaluar el SDK de ABAP en los siguientes codelabs.
- Crea una cuenta de servicio
abap-sdk-dev@abap-sdk-poc.iam.gserviceaccount.com,
que usará el SDK de ABAP.
5. Supervisa la instalación
La VM se creará en unos minutos, pero la instalación del contenedor de Docker de SAP tardará alrededor de 15 minutos.
Para supervisar el proceso de instalación, sigue estos pasos:
- Después de crear la VM, usa uno de los siguientes métodos para acceder al sistema a través de SSH:
- 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-2022"
- La secuencia de comandos de instalación crea un archivo de salida
/tmp/output.txt
. Para supervisar el proceso de instalación, ejecuta el comandotail
con este archivo.
tail -f /tmp/output.txt
- Espera hasta que veas el siguiente mensaje de confirmación en el archivo de salida que indica que el contenedor de Docker de SAP se está ejecutando.
También puedes ejecutar el siguiente comando para verificar si el contenedor se está ejecutando:
sudo docker ps
Con esto, se completa la instalación y ahora podemos pasar al 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 verificarla 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 es ABAPtr2022#00
. También está predefinida (misma contraseña) para el cliente 000, el cliente 001: SAP*, DDIC. Consulta aquí para obtener más información.
7. Renueva la licencia de prueba de SAP
Para renovar la licencia de prueba de SAP, sigue estos pasos:
- Accede al sistema con las siguientes credenciales:
Cliente: |
|
UserID: |
|
Contraseña: |
|
- Obtén la clave de hardware del código de transacción:
SLICENSE
- Genera una nueva clave de licencia desde el sitio SAP License Keys for Preview, Evaluation and Developer Versions. Selecciona el sistema
A4H
, actualiza los datos personales y la información del sistema con la clave de hardware, y acepta la licencia. Haz clic en el botón Generar para crear el archivo de clave de licenciaA4H_Multiple.txt
.
- Instala la nueva clave de licencia con el código de transacción
SLICENSE
.
- Ve al código de transacción
SLICENSE
, haz clic en el botón Install y selecciona el documento de texto descargadoA4H_Multiple.txt
. El sistema se extenderá por otros 3 meses.
8. Activa la configuración del TMS
Para importar transportes al sistema, debemos activar la configuración del TMS.
- Accede al sistema con el nombre de usuario
DEVELOPER
y la contraseñaABAPtr2022#00
. - Ve al código de transacción STMS > Overview > Imports.
- Selecciona Environment > System Overview.
- Selecciona Extras > Distribute and Activate Configuration.
- Ve al código de transacción STMS_IMPORT, donde deberías ver la siguiente pantalla:
Ahora el sistema SAP está listo para importar cualquier transporte.
9. Configura el certificado de confianza
Para conectarse de forma segura a las APIs de Google con el SDK de ABAP, se requieren certificados de confianza.
- Descarga los siguientes certificados del repositorio de Google Trust Services en tu computadora:
- GTS Root R1 (PEM)
- GTS CA 1C3 (PEM)
- 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.
- En STRUST, selecciona el nodo Cliente SSL Cliente SSL (estándar), haz clic en Importar certificado para subir ambos archivos, 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 el proceso, ejecutaremos la importación con una secuencia de comandos.
- Desde Cloud Shell, establece una conexión SSH con la VM de Docker de SAP:
gcloud compute ssh "abap-trial-docker-2022"
- Descarga y ejecuta la secuencia de comandos de transporte de importación:
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
- Cuando se complete, busca el paquete
/GOOG/ABAP_SDK
enSE80
. Ahora tienes instalado el SDK de ABAP.
11. Escribe un programa de ABAP de muestra con el SDK de ABAP
Escribamos un programa de muestra en ABAP para usar el servicio de Address Validation y corregir una dirección. Sigue el codelab Configura la autenticación del SDK de ABAP con tokens para SAP alojado en la VM de Compute Engine.
12. ¡Felicitaciones!
¡Felicitaciones! Instalaste correctamente ABAP Platform Trial 2022 en Google Cloud Platform y, luego, importaste los transportes para el 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 seguir 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 deseas continuar con los codelabs adicionales relacionados con el SDK de ABAP para Google Cloud, continúa con la limpieza.
Borra el proyecto
- Borra el proyecto de Google Cloud:
gcloud projects delete abap-sdk-poc
Borra recursos individuales
- Borra la instancia de procesamiento:
gcloud compute instances delete abap-trial-docker
- Borra las reglas de firewall:
gcloud compute firewall-rules delete sapmachine
- Borra la cuenta de servicio:
gcloud iam service-accounts delete \
abap-sdk-dev@abap-sdk-poc.iam.gserviceaccount.com