-
Notifications
You must be signed in to change notification settings - Fork 0
/
getting_started_with_devcontainer.html
275 lines (257 loc) · 21.4 KB
/
getting_started_with_devcontainer.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
<!doctype html>
<html dir="ltr" lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Comenzando con Contenedores de Desarrollo — Ruby on Rails Guides</title>
<link rel="stylesheet" type="text/css" href="stylesheets/style-v2.css" data-turbo-track="reload">
<link rel="stylesheet" type="text/css" href="stylesheets/print-v2.css" media="print">
<link rel="stylesheet" type="text/css" href="stylesheets/highlight-v2.css" data-turbo-track="reload">
<link rel="icon" href="images/favicon.ico" sizes="any">
<link rel="apple-touch-icon" href="images/icon.png">
<script src="javascripts/@hotwired--turbo.js" data-turbo-track="reload"></script>
<script src="javascripts/clipboard.js" data-turbo-track="reload"></script>
<script src="javascripts/guides.js" data-turbo-track="reload"></script>
<meta property="og:title" content="Comenzando con Contenedores de Desarrollo — Ruby on Rails Guides" />
<meta name="description" content="Comenzando con Contenedores de DesarrolloDespués de leer esta guía, sabrás: Cómo crear una nueva aplicación Rails con la herramienta rails-new. Cómo comenzar a trabajar con tu aplicación en un contenedor de desarrollo." />
<meta property="og:description" content="Comenzando con Contenedores de DesarrolloDespués de leer esta guía, sabrás: Cómo crear una nueva aplicación Rails con la herramienta rails-new. Cómo comenzar a trabajar con tu aplicación en un contenedor de desarrollo." />
<meta property="og:locale" content="en_US" />
<meta property="og:site_name" content="Ruby on Rails Guides" />
<meta property="og:image" content="https://avatars.githubusercontent.com/u/4223" />
<meta property="og:type" content="website" />
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Noto+Sans+Arabic:[email protected]&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/css2?family=Heebo:[email protected]&family=Noto+Sans+Arabic:[email protected]&display=swap" rel="stylesheet">
<meta name="theme-color" content="#C81418">
</head>
<body class="guide">
<nav id="topNav" aria-label="Secondary">
<div class="wrapper">
<strong class="more-info-label">Más en <a href="https://rubyonrails.org/">rubyonrails.org:</a> </strong>
<span class="red-button more-info-button">
Más Ruby on Rails
</span>
<ul class="more-info-links s-hidden">
<li class="more-info"><a href="https://rubyonrails.org/blog">Blog</a></li>
<li class="more-info"><a href="https://guides.rubyonrails.org/">Guías</a></li>
<li class="more-info"><a href="https://api.rubyonrails.org/">API</a></li>
<li class="more-info"><a href="https://discuss.rubyonrails.org/">Foro</a></li>
<li class="more-info"><a href="https://github.com/rails/rails">Contribuir en GitHub</a></li>
</ul>
</div>
</nav>
<header id="page_header">
<div class="wrapper clearfix">
<nav id="feature_nav">
<div class="header-logo">
<a href="index.html" title="Regresar a la página principal de Guías para Edge">Guías</a>
<span id="version_switcher">
Versión:
<select class="guides-version">
<option value="https://edgeguides.rubyonrails.org/" selected>Edge</option>
<option value="https://guides.rubyonrails.org/v7.2/">7.2</option>
<option value="https://guides.rubyonrails.org/v7.1/">7.1</option>
<option value="https://guides.rubyonrails.org/v7.0/">7.0</option>
<option value="https://guides.rubyonrails.org/v6.1/">6.1</option>
<option value="https://guides.rubyonrails.org/v6.0/">6.0</option>
<option value="https://guides.rubyonrails.org/v5.2/">5.2</option>
<option value="https://guides.rubyonrails.org/v5.1/">5.1</option>
<option value="https://guides.rubyonrails.org/v5.0/">5.0</option>
<option value="https://guides.rubyonrails.org/v4.2/">4.2</option>
<option value="https://guides.rubyonrails.org/v4.1/">4.1</option>
<option value="https://guides.rubyonrails.org/v4.0/">4.0</option>
<option value="https://guides.rubyonrails.org/v3.2/">3.2</option>
<option value="https://guides.rubyonrails.org/v3.1/">3.1</option>
<option value="https://guides.rubyonrails.org/v3.0/">3.0</option>
<option value="https://guides.rubyonrails.org/v2.3/">2.3</option>
</select>
</span>
</div>
<ul class="nav">
<li><a class="nav-item" id="home_nav" href="https://rubyonrails.org/">Inicio</a></li>
<li class="guides-index guides-index-large">
<a href="index.html" id="guidesMenu" class="guides-index-item nav-item">Índice de Guías</a>
<div id="guides" class="clearfix" style="display: none;">
<hr />
<dl class="guides-section-container">
<div class="guides-section">
<dt>Comienza Aquí</dt>
<dd><a href="getting_started.html">Primeros Pasos con Rails</a></dd>
</div>
<div class="guides-section">
<dt>Modelos</dt>
<dd><a href="active_record_basics.html">Conceptos Básicos de Active Record</a></dd>
<dd><a href="active_record_migrations.html">Migraciones de Active Record</a></dd>
<dd><a href="active_record_validations.html">Validaciones de Active Record</a></dd>
</div>
<div class="guides-section">
<dt>Vistas</dt>
<dd><a href="action_view_overview.html">Resumen de Action View</a></dd>
<dd><a href="layouts_and_rendering.html">Diseños y Renderizado en Rails</a></dd>
</div>
<div class="guides-section">
<dt>Controladores</dt>
<dd><a href="action_controller_overview.html">Resumen de Action Controller</a></dd>
<dd><a href="routing.html">Enrutamiento en Rails desde el Exterior</a></dd>
</div>
<div class="guides-section">
<dt>Otros Componentes</dt>
<dd><a href="active_support_core_extensions.html">Extensiones Básicas de Active Support</a></dd>
<dd><a href="action_mailer_basics.html">Conceptos Básicos de Action Mailer</a></dd>
<dd><a href="action_mailbox_basics.html">Conceptos Básicos de Action Mailbox</a></dd>
<dd><a href="action_text_overview.html">Resumen de Action Text</a></dd>
<dd><a href="active_job_basics.html">Conceptos Básicos de Active Job</a></dd>
</div>
<div class="guides-section">
<dt>Políticas</dt>
<dd><a href="maintenance_policy.html">Política de Mantenimiento</a></dd>
</div>
<div class="guides-section">
<dt>Notas de Lanzamiento</dt>
<dd><a href="upgrading_ruby_on_rails.html">Actualizando Ruby on Rails</a></dd>
<dd><a href="7_2_release_notes.html">Versión 7.2 - ?</a></dd>
<dd><a href="7_1_release_notes.html">Versión 7.1 - Octubre 2023</a></dd>
<dd><a href="7_0_release_notes.html">Versión 7.0 - Diciembre 2021</a></dd>
<dd><a href="6_1_release_notes.html">Versión 6.1 - Diciembre 2020</a></dd>
</div>
</dl>
</div>
</li>
<li><a class="nav-item" href="contributing_to_ruby_on_rails.html">Contribuir</a></li>
<li class="guides-index guides-index-small">
<select class="guides-index-item nav-item">
<option value="index.html">Índice de Guías</option>
<optgroup label="Comienza Aquí">
<option value="getting_started.html">Primeros Pasos con Rails</option>
</optgroup>
<optgroup label="Modelos">
<option value="active_record_basics.html">Conceptos Básicos de Active Record</option>
<option value="active_record_migrations.html">Migraciones de Active Record</option>
<option value="active_record_validations.html">Validaciones de Active Record</option>
</optgroup>
<optgroup label="Vistas">
<option value="action_view_overview.html">Resumen de Action View</option>
<option value="layouts_and_rendering.html">Diseños y Renderizado en Rails</option>
</optgroup>
<optgroup label="Controladores">
<option value="action_controller_overview.html">Resumen de Action Controller</option>
<option value="routing.html">Enrutamiento en Rails desde el Exterior</option>
</optgroup>
<optgroup label="Otros Componentes">
<option value="active_support_core_extensions.html">Extensiones Básicas de Active Support</option>
<option value="action_mailer_basics.html">Conceptos Básicos de Action Mailer</option>
<option value="action_mailbox_basics.html">Conceptos Básicos de Action Mailbox</option>
<option value="action_text_overview.html">Resumen de Action Text</option>
<option value="active_job_basics.html">Conceptos Básicos de Active Job</option>
</optgroup>
<optgroup label="Políticas">
<option value="maintenance_policy.html">Política de Mantenimiento</option>
</optgroup>
<optgroup label="Notas de Lanzamiento">
<option value="upgrading_ruby_on_rails.html">Actualizando Ruby on Rails</option>
<option value="7_2_release_notes.html">Versión 7.2 - ?</option>
<option value="7_1_release_notes.html">Versión 7.1 - Octubre 2023</option>
<option value="7_0_release_notes.html">Versión 7.0 - Diciembre 2021</option>
<option value="6_1_release_notes.html">Versión 6.1 - Diciembre 2020</option>
</optgroup>
</select>
</li>
</ul>
</nav>
</div>
</header>
<hr class="hide" />
<section id="feature">
<div class="wrapper">
<h1>Comenzando con Contenedores de Desarrollo</h1><p>Después de leer esta guía, sabrás:</p>
<ul>
<li>Cómo crear una nueva aplicación Rails con la herramienta <code>rails-new</code>.</li>
<li>Cómo comenzar a trabajar con tu aplicación en un contenedor de desarrollo.</li>
</ul>
<nav id="subCol">
<h3 class="chapter">
<picture>
<!-- Using the `source` HTML tag to set the dark theme image -->
<source
srcset="images/icon_book-close-bookmark-1-wht.svg"
media="(prefers-color-scheme: dark)"
/>
<img src="images/icon_book-close-bookmark-1.svg" alt="Chapter Icon" />
</picture>
Chapters
</h3>
<ol class="chapters">
<li><a href="#configuración-e-instalación">Configuración e Instalación</a>
<ul>
<li><a href="#instalación-de-docker">Instalación de Docker</a></li>
<li><a href="#instalación-de-vs-code">Instalación de VS Code</a></li>
<li><a href="#instalación-de-rails-new">Instalación de rails-new</a></li>
</ul></li>
<li><a href="#creación-de-la-aplicación-de-blog">Creación de la Aplicación de Blog</a></li>
<li><a href="#abrir-la-aplicación-de-blog-en-un-contenedor-de-desarrollo">Abrir la Aplicación de Blog en un Contenedor de Desarrollo</a></li>
</ol>
</nav>
<hr>
</div>
</section>
<main id="container">
<div class="wrapper">
<div id="mainCol">
<p>La mejor manera de leer esta guía es seguirla paso a paso. Todos los pasos son esenciales para ejecutar esta aplicación de ejemplo y no se necesita código o pasos adicionales.</p><p>Esta guía te ayuda a configurarte con <a href="https://containers.dev/">contenedores de desarrollo (o dev containers, por su abreviatura en inglés)</a> para un entorno de desarrollo completo. Los contenedores de desarrollo se utilizan para ejecutar tu aplicación Rails en un contenedor, sin necesidad de instalar Ruby o Rails o sus dependencias directamente en tu máquina. Esta es la forma más rápida de poner en funcionamiento tu aplicación Rails.</p><p>Esta es una alternativa a instalar Ruby y Rails directamente en tu máquina, lo cual está cubierto en las <a href="getting_started.html#creating-a-new-rails-project">guías de Introducción</a>. Una vez que hayas completado esta guía, puedes continuar construyendo tu aplicación siguiendo la guía de Introducción.</p><h2 id="configuración-e-instalación"><a class="anchorlink" href="#configuración-e-instalación"><span>1</span> Configuración e Instalación</a></h2><p>Para configurarte, necesitarás instalar las herramientas relevantes: Docker, VS Code y <code>rails-new</code>. Detallaremos cada una a continuación.</p><h3 id="instalación-de-docker"><a class="anchorlink" href="#instalación-de-docker"><span>1.1</span> Instalación de Docker</a></h3><p>Los contenedores de desarrollo se ejecutan usando Docker, una plataforma abierta para desarrollar, enviar y ejecutar aplicaciones. Puedes instalar Docker siguiendo las instrucciones de instalación para tu sistema operativo en los <a href="https://docs.docker.com/desktop/">documentos de Docker</a>.</p><p>Una vez que Docker se haya instalado, inicia la aplicación Docker para comenzar a ejecutar el motor Docker en tu máquina.</p><h3 id="instalación-de-vs-code"><a class="anchorlink" href="#instalación-de-vs-code"><span>1.2</span> Instalación de VS Code</a></h3><p>Visual Studio Code (VS Code) es un editor de código abierto desarrollado por Microsoft. La extensión Dev Containers de VS Code te permite abrir cualquier carpeta dentro de (o montada en) un contenedor y aprovechar el conjunto completo de características de Visual Studio Code. Un archivo <a href="https://code.visualstudio.com/docs/devcontainers/containers#_create-a-devcontainerjson-file">devcontainer.json</a> en tu proyecto le dice a VS Code cómo acceder (o crear) un contenedor de desarrollo con una pila de herramientas y tiempo de ejecución bien definida. Te permite iniciar rápidamente contenedores, acceder a comandos de terminal, depurar código y utilizar extensiones.</p><p>Puedes instalar VS Code descargándolo desde <a href="https://code.visualstudio.com/">el sitio web</a>.</p><p>Puedes instalar la extensión Dev Containers descargándola desde <a href="https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers">el mercado</a>.</p><h3 id="instalación-de-rails-new"><a class="anchorlink" href="#instalación-de-rails-new"><span>1.3</span> Instalación de rails-new</a></h3><p><code>rails-new</code> genera una nueva aplicación Rails para ti sin tener que instalar Ruby en tu máquina. Utiliza Docker para generar la aplicación Rails, permitiendo así que Docker se encargue de instalar las versiones correctas de Ruby y Rails para ti.</p><p>Para instalar <code>rails-new</code>, sigue las instrucciones de instalación <a href="https://github.com/rails/rails-new?tab=readme-ov-file#installation">en el README</a>.</p><h2 id="creación-de-la-aplicación-de-blog"><a class="anchorlink" href="#creación-de-la-aplicación-de-blog"><span>2</span> Creación de la Aplicación de Blog</a></h2><p>Rails viene con una serie de scripts llamados generadores que están diseñados para hacer tu vida de desarrollo más fácil al crear todo lo necesario para comenzar a trabajar en una tarea particular. Uno de estos es el generador de nueva aplicación, que te proporcionará la base de una nueva aplicación Rails para que no tengas que escribirla tú mismo. La herramienta <code>rails-new</code> utiliza este generador para crear una nueva aplicación Rails para ti.</p><p>NOTA: Los ejemplos a continuación usan <code>$</code> para representar tu indicador de terminal en un sistema operativo similar a UNIX, aunque puede haber sido personalizado para aparecer de manera diferente.</p><p>Para usar <code>rails-new</code> para generar tu aplicación, abre un terminal, navega a un directorio donde tengas derechos para crear archivos y ejecuta:</p><div class="interstitial code">
<pre><code class="highlight console"><span class="gp">$</span><span class="w"> </span>rails-new blog <span class="nt">--devcontainer</span>
</code></pre>
<button class="clipboard-button" data-clipboard-text="rails-new blog --devcontainer
">Copy</button>
</div>
<p>Esto creará una aplicación Rails llamada Blog en un directorio <code>blog</code>.</p><p>CONSEJO: Puedes ver todas las opciones de línea de comandos que acepta el generador de aplicaciones Rails ejecutando <code>rails-new --help</code>.</p><p>Después de crear la aplicación de blog, cambia a su carpeta:</p><div class="interstitial code">
<pre><code class="highlight console"><span class="gp">$</span><span class="w"> </span><span class="nb">cd </span>blog
</code></pre>
<button class="clipboard-button" data-clipboard-text="cd blog
">Copy</button>
</div>
<p>El directorio <code>blog</code> tendrá una serie de archivos y carpetas generados que componen la estructura de una aplicación Rails. La mayor parte del trabajo en este tutorial ocurrirá en la carpeta <code>app</code>. Para un resumen completo de todo en tu aplicación, consulta la guía completa de <a href="getting_started.html#creating-the-blog-application">Introducción</a>.</p><h2 id="abrir-la-aplicación-de-blog-en-un-contenedor-de-desarrollo"><a class="anchorlink" href="#abrir-la-aplicación-de-blog-en-un-contenedor-de-desarrollo"><span>3</span> Abrir la Aplicación de Blog en un Contenedor de Desarrollo</a></h2><p>Nuestra nueva aplicación Rails viene con un contenedor de desarrollo ya configurado y listo para usar. Usaremos VS Code para iniciar y trabajar con nuestro contenedor de desarrollo. Comienza lanzando VS Code y abriendo tu aplicación.</p><p>Una vez que la aplicación se abra, VS Code debería indicarte que ha encontrado un archivo de configuración de contenedor de desarrollo, y puedes reabrir la carpeta en un contenedor de desarrollo. Haz clic en el botón verde "Reopen in Container" para crear el contenedor de desarrollo.</p><p>Una vez que la configuración del contenedor de desarrollo esté completa, tu entorno de desarrollo estará listo para usar, con Ruby, Rails y todas tus dependencias instaladas.</p><p>Puedes abrir el terminal dentro de VS Code para verificar que Rails esté instalado:</p><div class="interstitial code">
<pre><code class="highlight console"><span class="gp">$</span><span class="w"> </span><span class="nb">rails</span> <span class="nt">--version</span>
<span class="go">Rails 7.2.0
</span></code></pre>
<button class="clipboard-button" data-clipboard-text="rails --version
">Copy</button>
</div>
<p>Ahora puedes continuar con la <a href="getting_started.html#hello-rails">guía de Introducción</a> y comenzar a construir tu aplicación de Blog. Estarás trabajando dentro de VS Code, que sirve como tu punto de entrada al contenedor de desarrollo de tu aplicación, donde puedes ejecutar código, ejecutar pruebas y ejecutar tu aplicación.</p>
<hr>
<h3>Comentarios</h3>
<p>
Se te anima a ayudar a mejorar la calidad de esta guía.
</p>
<p>
Por favor contribuye si ves algún error tipográfico o errores fácticos.
Para comenzar, puedes leer nuestra sección de <a href="https://edgeguides.rubyonrails.org/contributing_to_ruby_on_rails.html#contributing-to-the-rails-documentation">contribuciones a la documentación</a>.
</p>
<p>
También puedes encontrar contenido incompleto o cosas que no están actualizadas.
Por favor agrega cualquier documentación faltante para main. Asegúrate de revisar
<a href="https://edgeguides.rubyonrails.org">Guías Edge</a> primero para verificar
si los problemas ya están resueltos o no en la rama principal.
Revisa las <a href="ruby_on_rails_guides_guidelines.html">Guías de Ruby on Rails</a>
para estilo y convenciones.
</p>
<p>
Si por alguna razón detectas algo que corregir pero no puedes hacerlo tú mismo, por favor
<a href="https://github.com/rails/rails/issues">abre un issue</a>.
</p>
<p>Y por último, pero no menos importante, cualquier tipo de discusión sobre la
documentación de Ruby on Rails es muy bienvenida en el <a href="https://discuss.rubyonrails.org/c/rubyonrails-docs">Foro oficial de Ruby on Rails</a>.
</p>
</div>
</div>
</main>
<hr class="hide" />
<footer id="page_footer">
<div class="wrapper">
<p>Este trabajo está bajo una <a href="https://creativecommons.org/licenses/by-sa/4.0/">Licencia Creative Commons Atribución-CompartirIgual 4.0 Internacional</a></p>
<p>"Rails", "Ruby on Rails" y el logotipo de Rails son marcas registradas de David Heinemeier Hansson. Todos los derechos reservados.</p>
<p> Esta traducción fue generada por openAi e <a href="http://latinadeveloper.com/">Isis Harris.</a></p>
</div>
</footer>
</body>
</html>