Updated log messages and scripts

Author: manjavacas

Makefile

@@ -1,22 +1,23 @@
 LAUNCH_SCRIPT := ./scripts/launch.sh
-CLEAN_CLOUD_SCRIPT := ./scripts/clean_cloud.sh
+CLEAN_SCRIPT := ./scripts/clean.sh
 CONFIG_FILE := config.json
 
 all: launch
 
 launch: $(CONFIG_FILE)
-	@echo "Creando instancias de VM con la configuración $(CONFIG_FILE)..."
+	@echo "Creating VM instances with the configuration in $(CONFIG_FILE)..."
 	@bash $(LAUNCH_SCRIPT) $(CONFIG_FILE)
 
 clean:
-	@echo "Limpiando recursos en Google Cloud..."
-	@bash $(CLEAN_CLOUD_SCRIPT)
+	@echo "Clearing Google Cloud resources..."
+	@bash $(CLEAN_SCRIPT) $(CONFIG_FILE)
 
 reset: clean launch
 
 help:
-	@echo "Objetivos disponibles:"
-	@echo "  make launch [CONFIG_FILE=config.json] - Crea las instancias de VM según la configuración especificada (por defecto: config.json)."
-	@echo "  make clean                            - Limpia todas las instancias y buckets en Google Cloud."
-	@echo "  make reset                            - Limpia todos los recursos y luego crea nuevos."
-	@echo "  make help                             - Muestra esta ayuda."
+	@echo "CLOUDY commands:"
+	@echo "  make launch [CONFIG_FILE=config.json] - Creates VM instances according to the specified configuration (default: config.json)."
+	@echo "  make clean [CONFIG_FILE=config.json]  - Deletes all instances and buckets in Google Cloud (requires config.json)."
+	@echo "  make reset                            - Deletes all cloud resources and then creates new ones."
+	@echo "  make help                             - Displays this help."
+

README.md

@@ -7,42 +7,48 @@
 [![Release](https://badgen.net/github/release/manjavacas/cloudy)]()
 [![Contributors](https://badgen.net/github/contributors/manjavacas/cloudy)]() 
 
-**CLOUDY** automatiza la ejecución de experimentos en máquinas virtuales de [Google Cloud](https://console.cloud.google.com). Crea instancias y *buckets*, instala dependencias, ejecuta *scripts* de Python y maneja la limpieza de recursos.
+**CLOUDY** automates the execution of experiments on [Google Cloud](https://console.cloud.google.com). It creates instances and buckets, installs dependencies, runs Python scripts, and handles resource cleanup.
 
-## ⚙️ **¿Cómo funciona?**
+## ⚙️ **How it works?**
 
-El flujo de trabajo de **CLOUDY** es el siguiente:
+The workflow of **CLOUDY** comprises the following steps:
 
-1. El *script* `launch.sh` lanza un número determinado de instancias de máquinas virtuales, de acuerdo a las opciones especificadas en el fichero `config.json`.
+1. The script `launch.sh` launches a specified number of virtual machine instances, according to the options specified in the `config.json` file.
 
-2. En cada máquina virtual se ejecuta el *script* `setup.sh`, que instala dependencias, descarga un repositorio y ejecuta un *script* especificado.
+2. The script `setup.sh` is executed in each VM to install dependencies, download the specified repository and run the Python script indicated.
 
-3. La salida se guarda en un *bucket* existente, o lo crea en caso contrario.
+3. The output is saved to an existing bucket, or a new one is created as required.
 
-4. Las máquinas se autoeliminan una vez finalizada su ejecución.
+4. The instances are automatically deleted once their execution has finished.
 
 <p align="center">
-    <img src="images/diagram.png" alt="DIAGRAMA" width=80% />
+    <img src="images/diagram.png" alt="DIAGRAM" width=80% />
 </p>
 
 ## 📄 **Scripts**
 
-Este proyecto consta de los siguientes *scripts*:
+This project consists of the following scripts:
 
--  `launch.sh`: crea instancias de máquinas virtuales en Google Cloud según la configuración definida en `config.json`.
--  `setup.sh`: se ejecuta en cada instancia creada, instala dependencias, clona un repositorio, ejecuta un *script* de Python y guarda los resultados en un *bucket* de Google Cloud.
--  `clean_cloud.sh`: limpia todas las instancias de máquinas virtuales y *buckets* en Google Cloud.
--  `Makefile`: facilita la ejecución de los *scripts* mediante comandos simples.
+- `launch.sh`: creates VM instances on Google Cloud according to the configuration defined in `config.json`.
+- `setup.sh`: runs on each VM instance. Installs dependencies, clones a repository, runs a Python script, and saves the results to a Google Cloud bucket, creating it if necessary.
+- `clean.sh`: cleans up all virtual machine instances and buckets on Google Cloud.
+- `Makefile`: enables the execution of the scripts through simple commands.
 
-## 💻 **¿Cómo utilizar CLOUDY?**
+## 💻 **How to use CLOUDY?**
 
-0. **Prerrequisitos**.
+1. **Prerequisites**
 
-   Debes contar con una [cuenta de servicio en GCP](https://cloud.google.com/iam/docs/service-accounts-create?hl=es-419) con los permisos requeridos por *Compute engine* y *Cloud Storage* (ej. administrador de almacenamiento, administrador de instancias de compute).
+   First, create a [service account on GCP](https://cloud.google.com/iam/docs/service-accounts-create?hl=en) with the required permissions for Compute Engine and Cloud Storage (e.g., *storage administrator*, *compute instances administrator*).
 
-1. **Definir `config.json`.**
+   Then, install the following dependencies:
 
-   Define tu configuración en el archivo `config.json`, ubicado en el directorio raíz del proyecto. Por ejemplo:
+    - `Google Cloud SDK`: required to interact with Google Cloud from the command line.
+
+    - `jq`: used to read the JSON configuration file.
+
+2. **Edit `config.json`**
+
+   Define your custom configuration in the `config.json` file, located in the root directory of the project. For example:
 
    ```json
     {
@@ -64,36 +70,29 @@ Este proyecto consta de los siguientes *scripts*:
     }
     ```
 
-    Los principales campos a editar son:
-
-    - `INSTANCE_NAME_BASE` y `BUCKET_NAME`: identificador de las instancias y *bucket* creados.
-    - `REPO_NAME` y `REPO_URL`: repositorio a clonar. En él se ubica el código que queremos ejecutar.
-    - `DEPENDENCIES`: dependencias requeridas para ejecutar el *script*.
-    - `SCRIPT_PATH` y `SCRIPT_ARGS`: ruta al *script* de Python que se encuentra en el repositorio y que queremos ejecutar, así como argumentos de entrada.
-    - `SERVICE_ACCOUNT`: cuenta de servicio en GCP que vamos a utilizar. Debe contar con los permisos necesarios.
-
-
-2. **Instalar las dependencias necesarias.**
-
-    - `Google Cloud SDK`: necesario para interactuar con Google Cloud desde la línea de comandos.
+    The main options to edit are:
 
-    - `jq`: empleado para leer el archivo JSON de configuración.
+    - `INSTANCE_NAME_BASE` and `BUCKET_NAME`: identifiers for the created instances and bucket.
+    - `REPO_NAME` and `REPO_URL`: repository to clone. This is where the code you want to execute is located.
+    - `SCRIPT_PATH` and `SCRIPT_ARGS`: path to the Python script you want to execute in the repository, along with its input arguments.
+    - `DEPENDENCIES`: dependencies required to run the Python script.
+    - `SERVICE_ACCOUNT`: GCP service account to be used. It must have the necessary permissions.
 
-3. **Ejecución.**
+3. **Run CLOUDY**
 
-    - Para crear las instancias de máquinas virtuales, ejecuta:
+    - To launch the virtual machine instances, run:
 
     ```bash
     make launch
     ```
 
-    - Para limpiar todas las instancias y *buckets*, ejecuta:
+    - To clean up all instances and buckets, run:
 
     ```bash
     make clean
     ```
 
-    - Para eliminar máquinas y *buckets* y volver a lanzar:
+    - To delete machines and buckets and then relaunch, run:
 
     ```bash
     make reset

scripts/clean_cloud.sh renamed to scripts/clean.sh

@@ -14,32 +14,32 @@ CONFIG_FILE="config.json"
 
 ZONE=$(jq -r '.ZONE' $CONFIG_FILE)
 
-# Eliminar instancias de VM
+# Delete VM instances
 INSTANCES=$(gcloud compute instances list --format="value(name)" --filter="zone:($ZONE)" 2>/dev/null)
 
 if [ -z "$INSTANCES" ]; then
-  warn "No hay instancias de VM para eliminar."
+  warn "No VM instances to delete."
 else
-  info "Eliminando instancias de VM..."
+  info "Deleting VM instances..."
   for INSTANCE in $INSTANCES; do
-    info "Eliminando instancia: $INSTANCE..."
+    info "Deleting instance: $INSTANCE..."
     gcloud compute instances delete "$INSTANCE" --zone="$ZONE" --quiet
   done
-  info "Todas las instancias de VM han sido eliminadas."
+  info "All VM instances have been deleted."
 fi
 
-# Eliminar buckets
+# Delete buckets
 BUCKETS=$(gsutil ls)
 
 if [ -z "$BUCKETS" ]; then
-  warn "No hay buckets de GCS para eliminar."
+  warn "No GCS buckets to delete."
 else
-  info "Eliminando buckets de GCS..."
+  info "Deleting GCS buckets..."
   for BUCKET in $BUCKETS; do
-    info "Eliminando bucket: $BUCKET..."
+    info "Deleting bucket: $BUCKET..."
     gsutil rm -r "$BUCKET"
   done
-  info "Todos los buckets de GCS han sido eliminados."
+  info "All GCS buckets have been deleted."
 fi
 
-info "Proceso de eliminación completado."
+info "Deletion process completed."

scripts/launch.sh

@@ -26,7 +26,7 @@ SCRIPT_ARGS=$(jq -r '.SCRIPT_ARGS' $CONFIG_FILE)
 for ((i = 1; i <= N_VMS; i++)); do
     INSTANCE_NAME="$INSTANCE_NAME_BASE-$i"
 
-    info "Creando instancia: $INSTANCE_NAME..."
+    info "Creating instance: $INSTANCE_NAME..."
     gcloud compute instances create "$INSTANCE_NAME" \
         --zone="$ZONE" \
         --machine-type="$MACHINE_TYPE" \
@@ -35,16 +35,16 @@ for ((i = 1; i <= N_VMS; i++)); do
         --service-account="$SERVICE_ACCOUNT" \
         --scopes https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/devstorage.full_control
 
-    while ! gcloud compute ssh "$INSTANCE_NAME" --zone="$ZONE" --command="info Instancia preparada" 2>/dev/null; do
-        info "Esperando a que el servicio SSH esté disponible..."
+    while ! gcloud compute ssh "$INSTANCE_NAME" --zone="$ZONE" --command="info Instance ready!" 2>/dev/null; do
+        info "Waiting for SSH service to be available..."
         sleep 10
     done
 
-    info "Copiando el script de setup en la instancia..."
+    info "Copying setup script to the VM instance..."
     gcloud compute scp scripts/$SETUP_SCRIPT "$INSTANCE_NAME:~/" --zone="$ZONE"
 
-    info "Ejecutando el script de setup en la instancia..."
+    info "Running setup script on the VM instance..."
     gcloud compute ssh "$INSTANCE_NAME" --zone="$ZONE" --command="chmod +x ~/$SETUP_SCRIPT && ~/$SETUP_SCRIPT '$INSTANCE_NAME' '$BUCKET_NAME' '$BUCKET_ZONE' '$REPO_NAME' '$REPO_URL' '$SCRIPT_PATH' '$DEPENDENCIES' '$SCRIPT_ARGS' '$ZONE'"
 
-    info "Fin del proceso de creación de $INSTANCE_NAME."
+    info "$INSTANCE_NAME finished!"
 done

scripts/setup.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 
 if [ "$#" -ne 9 ]; then
-  error "Se deben proporcionar todos los argumentos necesarios."
+  error "All required arguments must be provided."
   exit 1
 fi
 
@@ -17,68 +17,68 @@ ZONE="$9"
 
 info() {
   local message="$1"
-  echo -e "\033[32m[CLOUDY $MACHINE_NAME] $message\033[0m" # Verde
+  echo -e "\033[32m[CLOUDY $MACHINE_NAME] $message\033[0m" # Green
 }
 
 warn() {
   local message="$1"
-  echo -e "\033[33m[CLOUDY $MACHINE_NAME] $message\033[0m" # Amarillo
+  echo -e "\033[33m[CLOUDY $MACHINE_NAME] $message\033[0m" # Yellow
 }
 
 error() {
   local message="$1"
-  echo -e "\033[31m[CLOUDY $MACHINE_NAME] Error: $message\033[0m" # Rojo
+  echo -e "\033[31m[CLOUDY $MACHINE_NAME] Error: $message\033[0m" # Red
 }
 
 OUTPUT_FILE="output_${MACHINE_NAME}.txt"
 
-info "Actualizando e instalando dependencias..."
+info "Updating and installing dependencies..."
 
-# Redirigir stdout y stderr a /dev/null para ocultar la salida
 sudo apt-get update >/dev/null 2>&1
 sudo apt-get upgrade -y >/dev/null 2>&1
 sudo apt-get install -y python3 python3-pip >/dev/null 2>&1
 
 pip3 install $DEPENDENCIES >/dev/null 2>&1
 
-info "Clonando repositorio..."
+info "Cloning repository $REPO_NAME..."
 
 git clone "$REPO_URL" >/dev/null 2>&1
 cd "$REPO_NAME"
 
-info "Ejecutando script..."
+info "Running script: python3 $SCRIPT_PATH $SCRIPT_ARGS..."
 
 python3 "$SCRIPT_PATH" $SCRIPT_ARGS >"$OUTPUT_FILE" 2>&1
 
 if [ -f "$OUTPUT_FILE" ]; then
 
   if ! command -v gsutil &>/dev/null; then
-    info "Instalando Google Cloud SDK..."
+    info "Installing Google Cloud SDK..."
     sudo apt-get install -y google-cloud-sdk >/dev/null 2>&1
   fi
 
   if gsutil ls -b "gs://$BUCKET_NAME" &>/dev/null; then
-    info "El bucket gs://$BUCKET_NAME existe."
+    info "The bucket gs://$BUCKET_NAME already exists."
   else
-    warn "El bucket gs://$BUCKET_NAME NO existe. Creando bucket..."
+    warn "The bucket gs://$BUCKET_NAME does NOT exist. Creating bucket..."
     gsutil mb -l $BUCKET_ZONE "gs://$BUCKET_NAME/" >/dev/null 2>&1
   fi
 
-  info "Guardando $OUTPUT_FILE en el bucket gs://$BUCKET_NAME/..."
+  info "Saving $OUTPUT_FILE to bucket gs://$BUCKET_NAME/..."
   gsutil cp "$OUTPUT_FILE" "gs://$BUCKET_NAME/" >/dev/null 2>&1
 
   if [ $? -eq 0 ]; then
-    info "Archivo guardado en gs://$BUCKET_NAME/$OUTPUT_FILE"
+    info "File saved to gs://$BUCKET_NAME/$OUTPUT_FILE!"
   else
-    error "No se pudo guardar el archivo en Google Cloud Storage."
+    error "Failed to save the file in Google Cloud Storage."
     exit 1
   fi
 
 else
-  error "No se encontró el archivo de salida $OUTPUT_FILE"
+  error "Output file $OUTPUT_FILE not found!"
   exit 1
 fi
 
-info "Eliminando instancia..."
-gcloud compute instances delete "$MACHINE_NAME" --zone="$ZONE" --quiet 2>&1
-
+info "Deleting instance..."
+if ! gcloud compute instances delete "$MACHINE_NAME" --zone="$ZONE" --quiet >/dev/null 2>&1; then
+  echo "Failed to delete instance $MACHINE_NAME."
+fi