> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeros pasos en Square Cloud con Ruby

> Aprende cómo empezar en Square Cloud con Ruby

## 🚀 Introducción

* Antes de empezar, asegúrate de que Ruby esté instalado en tu sistema. Si aún no lo tienes, puedes descargarlo desde el [sitio web oficial de Ruby](https://www.ruby-lang.org/en/), o usar gestores de versiones como [rbenv](https://github.com/rbenv/rbenv) o [rvm](https://rvm.io/).
* A continuación, deberás crear una cuenta en Square Cloud, lo cual puedes hacer a través de la [página de inicio de sesión](https://squarecloud.app/es/signup). Puedes usar tu correo electrónico, GitHub o ambos para crear la cuenta.
* Por último, necesitas tener un plan de pago activo en tu cuenta. Puedes ver nuestros planes y adquirir uno según tus necesidades [aquí](https://squarecloud.app/es/pricing).

## ⚙️ Configuración del archivo squarecloud.app

<Note>
  Si estás subiendo tu aplicación a través del sitio web de Square Cloud, puedes ignorar esta sección. El sitio crea automáticamente el archivo de configuración `squarecloud.app` por ti.
</Note>

<Card title="Más información: cómo crear el archivo de configuración para Square Cloud." icon="link" href="https://docs.squarecloud.app/es/getting-started/config-file">
  El archivo squarecloud.app es un archivo de configuración que se usará para
  configurar tu aplicación; servirá para definir el nombre, la descripción,
  la versión, el archivo principal, entre otras cosas.
</Card>

## 📄 Archivos requeridos

* main.rb (Ejemplo de archivo principal — tu punto de entrada de Ruby).
* Gemfile (Archivo de dependencias, si usas Bundler).
* Gemfile.lock (Generado por Bundler; se recomienda incluirlo para builds reproducibles).
* [squarecloud.app](https://docs.squarecloud.app/es/getting-started/config-file) (archivo que contiene la configuración de Square Cloud).

## ▶️ Cómo iniciar tu aplicación

* Si el campo `START` no está definido en el archivo de configuración, Square Cloud ejecutará `ruby MAIN`, donde el archivo especificado en `MAIN` es el archivo Ruby (por ejemplo, `main.rb`). Si el campo `START` está definido, se ejecutará directamente el valor que contenga. En aplicaciones que usan Bundler, es común definir `START` como `bundle exec ruby main.rb` u otro comando de inicio adecuado. Para más información sobre los parámetros del archivo de configuración, visita [parámetros de configuración](https://docs.squarecloud.app/es/getting-started/config-file#configuration-parameters).

<Info>Para aplicaciones Ruby que usan **Bundler**, es importante configurar correctamente las variables de entorno para optimizar el proceso de instalación de dependencias en Square Cloud. Square Cloud ejecuta la instalación de bundler usando variables de entorno. Para excluir grupos de gems innecesarios en producción, configura la variable `BUNDLE_WITHOUT=development:test`. Esto también ayuda a eliminar las **deprecations** de **Bundler 2.x**.</Info>

## 🖥️ Preparando el proyecto

Antes de alojar tu proyecto en Square Cloud, verifica que los archivos del proyecto estén correctamente configurados para el alojamiento.

<Warning>El archivo de configuración (`squarecloud.app/.config`) debe estar ubicado en la raíz del archivo zip. De lo contrario, Square Cloud no podrá encontrarlo durante el deploy.</Warning>

## 📤 Cómo alojar tu proyecto

Ahora que has preparado todos los archivos para tu proyecto Ruby, el siguiente paso es subirlos a Square Cloud y poner tu aplicación en línea. Hay varias formas de subir, pero cubriremos dos: a través del Dashboard o a través de la CLI.

### A través del panel

<Steps>
  <Step title="Accede a la página de subida">
    Accede a la [página de subida](https://squarecloud.app/es/dashboard/new) y sube el archivo zip de tu proyecto.
  </Step>

  <Step title="Configura tu entorno">
    Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.\
    Si estás subiendo un proyecto web, asegúrate de seleccionar "Publicación Web" y de definir un subdominio para tu proyecto.
  </Step>

  <Step title="Despliega tu proyecto">
    Por último, haz clic en el botón "Deploy" para alojar tu proyecto en Square Cloud.\
    Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/dashboard/uploading.gif" alt="Subiendo aplicación a Square Cloud" style={{ borderRadius: "0.2rem" }} />
    </Frame>
  </Step>
</Steps>

### A través de la CLI

Para usar este método, necesitas crear un archivo de configuración llamado `squarecloud.app` en el directorio raíz de tu proyecto. Este archivo contendrá la configuración necesaria para tu proyecto.

<Card title="Aprende más sobre: cómo crear el archivo de configuración para Square Cloud." icon="link" href="/es/getting-started/config-file">
  El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; se utilizará para definir tu entorno.
</Card>

<Steps>
  <Step title="Instala la CLI">
    Primero, necesitas tener la CLI instalada en tu entorno. Si aún no la tienes, ejecuta el siguiente comando en tu terminal:

    ```
    npm install -g @squarecloud/cli
    ```

    Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:

    <Tabs>
      <Tab title="Windows">
        ```bash theme={null}
        squarecloud update
        ```
      </Tab>

      <Tab title="Linux, macOS y WSL">
        ```bash theme={null}
        curl -fsSL https://cli.squarecloud.app/install | bash
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Autentícate">
    Ahora, para autenticarte y usar otros comandos de la CLI, encontrarás tu clave de autorización [aquí](https://squarecloud.app/es/account/security) haciendo clic en "Request API Key". Después de obtener tu clave de autorización, ejecuta el siguiente comando:

    ```bash theme={null}
    squarecloud auth login
    ```
  </Step>

  <Step title="Sube tu proyecto">
    Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando:

    ```bash theme={null}
    squarecloud upload 
    ```

    O si creaste el zip manualmente, puedes usar:

    ```bash theme={null}
    squarecloud upload --file <path/to/zip> 
    ```
  </Step>
</Steps>

## Contáctanos

Si continúas enfrentando **dificultades técnicas**, nuestro **equipo de soporte especializado** está disponible para ayudarte. [**Contáctanos**](https://squarecloud.app/es/support) y estaremos encantados de ayudarte a resolver cualquier problema.