Comienza con el controlador Ruby

Instalar las dependencias.

Antes de empezar a desarrollar, asegúrate 2de instalar Ruby versión.7 o posterior en tu entorno de desarrollo. Ruby está preinstalado en macOS y algunas distribuciones de Linux, pero podrías necesitar actualizar tu versión.

Crea un directorio de proyecto.

Ejecuta el siguiente comando en tu shell para crear un directorio llamado ruby-quickstart para este proyecto:

mkdir ruby-quickstart

Luego, ejecuta los siguientes comandos para crear un archivo quickstart.rb en el directorio ruby-quickstart:

cd ruby-quickstart
touch quickstart.rb

Agregue el controlador Ruby a su proyecto.

Abre el archivo quickstart.rb y añade el siguiente código:

require 'bundler/inline'
gemfile do
  source 'https://rubygems.org'
  gem 'mongo'
end

Este código agrega el controlador Ruby como dependencia utilizando la Bundler herramienta de gestión de dependencias.

gemfile do
   source 'https://rubygems.org'
   gem 'mongo'
   gem 'bigdecimal'
end

Crea una implementación gratuita de MongoDB en Atlas.

Completa la Guía de inicio de MongoDB para configurar una nueva cuenta de Atlas y cargar datos de muestra en una nueva implementación de MongoDB de nivel gratuito.

Guarda tus credenciales.

Después de crear un usuario de base de datos, guardar el nombre de usuario y la contraseña de ese usuario en una ubicación segura para usarlos en un paso próximo.

Encuentra tu cadena de conexión de MongoDB Atlas.

Para recuperar la cadena de conexión para la implementación que creó en el paso anterior, inicie sesión en su cuenta de Atlas y navegue a la página Clusters bajo la sección Database. Haga clic en el botón Connect para la nueva implementación.

Si aún no tienes un usuario de base de datos configurado, MongoDB te pedirá que crees y configures un nuevo usuario.

Haz clic en el botón Drivers en la sección Connect to your application y selecciona "Ruby" del menú de selección Driver y la versión que mejor coincida con la versión que instalaste desde el menú de selección Version.

Asegúrate de que la opción View full code sample esté desmarcada para ver solo la cadena de conexión.

Copie su cadena de conexión.

Haga clic en el botón Copiar a la derecha de la cadena de conexión para copiarla al portapapeles, como se muestra en la siguiente captura de pantalla:

Actualiza el marcador de posición de la contraseña.

Pega esta cadena de conexión en un archivo en tu editor de texto preferido y reemplaza el marcador de posición <db_password> con la contraseña de tu usuario de base de datos. La cadena de conexión ya está completada con el nombre de usuario de tu usuario de base de datos.

Guarda este archivo en una ubicación segura para usarlo en el siguiente paso.

Edite su archivo de aplicación Ruby.

Navega a tu archivo quickstart.rb en el directorio ruby-quickstart. Copia y pega el siguiente código por debajo del código de Bundler del paso Descargar e Instalar de este tutorial. Este código se conecta a MongoDB y hace un query a la colección movies en la base de datos sample_mflix.

uri = '<connection string>'
begin
  client = Mongo::Client.new(uri)
  database = client.use('sample_mflix')
  movies = database[:movies]
  # Queries for a movie that has the title 'Back to the Future'
  query = { title: 'Back to the Future' }
  movie = movies.find(query).first
  # Prints the movie document
  puts movie
ensure
  client&.close
end

Asigna la cadena de conexión.

Reemplace el token <connection string> por la cadena de conexión que copió del paso Crear una cadena de conexión de este tutorial.

Ejecuta tu aplicación Ruby.

Desde tu directorio ruby-quickstart, ejecuta el siguiente comando de shell para ejecutar la aplicación:

ruby quickstart.rb

La salida de la línea de comandos contiene detalles sobre el documento de película recuperado:

{"_id"=>BSON::ObjectId('...'), "plot"=>"A young man is accidentally sent
30 years into the past in a time-traveling DeLorean invented by his friend,
Dr. Emmett Brown, and must make sure his high-school-age parents unite
in order to save his own existence.", ...
"title"=>"Back to the Future", ...

Si encuentras un error o no ves salida, asegúrate de haber especificado la cadena de conexión correcta en el archivo quickstart.rb y de haber cargado los datos de muestra.