Inicio rápido: Ejecución de imágenes de contenedor de SQL Server con DockerQuickstart: Run SQL Server container images with Docker

En este inicio rápido, deberá usar Docker para extraer y ejecutar la imagen de contenedor de SQL Server 2017, mssql-server-linux.In this quickstart, you use Docker to pull and run the SQL Server 2017 container image, mssql-server-linux. A continuación, tendrá que conectar con sqlcmd para crear la primera base de datos y ejecutar consultas.Then connect with sqlcmd to create your first database and run queries.

En este inicio rápido, usará Docker para extraer y ejecutar la imagen de contenedor de SQL Server 2019, mssql-server.In this quickstart, you use Docker to pull and run the SQL Server 2019 container image, mssql-server. A continuación, tendrá que conectar con sqlcmd para crear la primera base de datos y ejecutar consultas.Then connect with sqlcmd to create your first database and run queries.

Extracción y ejecución de la imagen de contenedor 2017Pull and run the 2017 container image

Antes de iniciar los pasos siguientes, asegúrese de que ha seleccionado el shell preferido (Bash, PowerShell o cmd) en la parte superior de este artículo.Before starting the following steps, make sure that you have selected your preferred shell (bash, PowerShell, or cmd) at the top of this article.

1. Extraiga la imagen de contenedor de Linux de SQL Server 2017 desde Microsoft Container Registry.Pull the SQL Server 2017 Linux container image from Microsoft Container Registry.

   sudo docker pull mcr.microsoft.com/mssql/server:2017-latest
   

   docker pull mcr.microsoft.com/mssql/server:2017-latest
   

   docker pull mcr.microsoft.com/mssql/server:2017-latest
   

   Sugerencia

   Si quiere crear contenedores de SQL Server 2019, vea la versión de SQL Server 2019 de este artículo.If you want to run SQL Server 2019 containers, see the SQL Server 2019 version of this article.

   En el comando anterior, se extrae la última imagen de contenedor de SQL Server 2017.The previous command pulls the latest SQL Server 2017 container image. Si quiere extraer una imagen específica, agregue dos puntos y el nombre de etiqueta (por ejemplo, mcr.microsoft.com/mssql/server:2017-GA-ubuntu).If you want to pull a specific image, you add a colon and the tag name (for example, mcr.microsoft.com/mssql/server:2017-GA-ubuntu). Para ver todas las imágenes disponibles, vea la página de Docker Hub de mssql-server.To see all available images, see the mssql-server Docker hub page.

   En los comandos de Bash de este artículo se usa sudo.For the bash commands in this article, sudo is used. En macOS, es posible que no se necesite sudo.On macOS, sudo might not be required. En Linux, si no quiere usar sudo para ejecutar Docker, puede configurar un grupo de Docker y agregarle usuarios.On Linux, if you do not want to use sudo to run Docker, you can configure a docker group and add users to that group. Para obtener más información, vea Pasos posteriores a la instalación para Linux.For more information, see Post-installation steps for Linux.

2. Para ejecutar la imagen de contenedor con Docker, puede usar el siguiente comando desde un shell de Bash (Linux y macOS), o bien una línea de comandos de PowerShell con privilegios elevados.To run the container image with Docker, you can use the following command from a bash shell (Linux/macOS) or elevated PowerShell command prompt.

   sudo docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" \
      -p 1433:1433 --name sql1 -h sql1 \
      -d \
      mcr.microsoft.com/mssql/server:2017-latest
   

   Nota

   Si usa PowerShell Core, reemplace las comillas dobles por comillas simples.If you are using PowerShell Core, replace the double quotes with single quotes.

   docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" `
      -p 1433:1433 --name sql1 -h sql1 `
      -d `
      mcr.microsoft.com/mssql/server:2017-latest
   

   docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" `
      -p 1433:1433 --name sql1 -h sql1 `
      -d `
      mcr.microsoft.com/mssql/server:2017-latest
   

   Nota

   La contraseña debe seguir la directiva de contraseñas predeterminada de SQL Server. En caso contrario, el contenedor no podrá instalar SQL Server y dejará de funcionar.The password should follow the SQL Server default password policy, otherwise the container can not setup SQL server and will stop working. De forma predeterminada, la contraseña debe tener al menos 8 caracteres y contener caracteres de tres de los cuatro conjuntos siguientes: Letras mayúsculas, letras minúsculas, dígitos de Base 10 y símbolos.By default, the password must be at least 8 characters long and contain characters from three of the following four sets: Uppercase letters, Lowercase letters, Base 10 digits, and Symbols. Puede examinar el registro de errores ejecutando el comando docker logs.You can examine the error log by executing the docker logs command.

   De forma predeterminada, se creará un contenedor con la edición para desarrolladores de SQL Server 2017.By default, this creates a container with the Developer edition of SQL Server 2017. El proceso para ejecutar las ediciones de producción en contenedores es ligeramente diferente.The process for running production editions in containers is slightly different. Para obtener más información, vea Run production container image (Ejecutar imágenes de contenedor de producción).For more information, see Run production container images.

   En la tabla siguiente, se proporciona una descripción de los parámetros del ejemplo de docker run anterior:The following table provides a description of the parameters in the previous docker run example:

   ParámetroParameter	DescripciónDescription
   -e "ACCEPT_EULA=Y"-e "ACCEPT_EULA=Y"	Establezca la variable ACCEPT_EULA en cualquier valor para confirmar que acepta el Contrato de licencia de usuario final.Set the ACCEPT_EULA variable to any value to confirm your acceptance of the End-User Licensing Agreement. Configuración requerida para la imagen de SQL Server.Required setting for the SQL Server image.
   -e "SA_PASSWORD=<YourStrong@Passw0rd\>"-e "SA_PASSWORD=<YourStrong@Passw0rd\>"	Especifique una contraseña segura propia con al menos 8 caracteres y que cumpla los requisitos de contraseña de SQL Server.Specify your own strong password that is at least 8 characters and meets the SQL Server password requirements. Configuración requerida para la imagen de SQL Server.Required setting for the SQL Server image.
   -p 1433:1433-p 1433:1433	Asigne un puerto TCP en el entorno de host (el primer valor) a un puerto TCP en el contenedor (el segundo valor).Map a TCP port on the host environment (first value) with a TCP port in the container (second value). En este ejemplo, SQL Server escucha en TCP 1433 en el contenedor y se expone al puerto 1433 del host.In this example, SQL Server is listening on TCP 1433 in the container and this is exposed to the port, 1433, on the host.
   --name sql1--name sql1	Especifique un nombre personalizado para el contenedor en lugar de uno generado aleatoriamente.Specify a custom name for the container rather than a randomly generated one. Si ejecuta más de un contenedor, no podrá usar el mismo nombre.If you run more than one container, you cannot reuse this same name.
   -h sql1-h sql1	Cuando se usa para establecer explícitamente el nombre de host del contenedor, si no se especifica, el valor predeterminado es el identificador del contenedor, que es un GUID del sistema generado aleatoriamente.Used to explicitly set the container hostname, if you don't specify it, it defaults to the container ID which is a randomly generated system GUID.
   -d-d	Ejecute el contenedor en segundo plano (demonio).Run the container in the background (daemon)
   mcr.microsoft.com/mssql/server:2017-latestmcr.microsoft.com/mssql/server:2017-latest	La imagen de contenedor de SQL Server 2017 para Linux.The SQL Server 2017 Linux container image.

3. Para ver los contenedores de Docker, use el comando docker ps.To view your Docker containers, use the docker ps command.

   sudo docker ps -a
   

   docker ps -a
   

   docker ps -a
   

   Debería ver un resultado similar al de la captura de pantalla siguiente:You should see output similar to the following screenshot:

   

4. Si la columna ESTADO muestra el estado Activo, esto indica que SQL Server se está ejecutando en el contenedor y que está escuchando en el puerto especificado en la columna PUERTOS.If the STATUS column shows a status of Up, then SQL Server is running in the container and listening on the port specified in the PORTS column. Si la columna ESTADO de su contenedor de SQL Server muestra Cerrado, consulte la sección Solución de problemas de la guía de configuración.If the STATUS column for your SQL Server container shows Exited, see the Troubleshooting section of the configuration guide.

El parámetro -h (nombre de host), tal y como se indicó anteriormente, cambia el nombre interno del contenedor a un valor personalizado.The -h (host name) parameter as discussed above, changes the internal name of the container to a custom value. Este es el nombre que verá que se devuelve en la siguiente consulta de Transact-SQL:This is the name you'll see returned in the following Transact-SQL query:

SELECT @@SERVERNAME,
    SERVERPROPERTY('ComputerNamePhysicalNetBIOS'),
    SERVERPROPERTY('MachineName'),
    SERVERPROPERTY('ServerName')

Establecer -h y --name en el mismo valor es una buena manera de identificar fácilmente el contenedor de destino.Setting -h and --name to the same value is a good way to easily identify the target container.

5. Como paso final, cambie la contraseña de administrador del sistema porque SA_PASSWORD se ve en la salida de ps -eax y se almacena en la variable de entorno con el mismo nombre.As a final step, change your SA password because the SA_PASSWORD is visible in ps -eax output and stored in the environment variable of the same name. Vea los pasos siguientes.See steps below.

Extracción y ejecución de la imagen de contenedor 2019Pull and run the 2019 container image

Antes de iniciar los pasos siguientes, asegúrese de que ha seleccionado el shell preferido (Bash, PowerShell o cmd) en la parte superior de este artículo.Before starting the following steps, make sure that you have selected your preferred shell (bash, PowerShell, or cmd) at the top of this article.

1. Extraiga la imagen de contenedor de Linux de SQL Server 2019 desde Microsoft Container Registry.Pull the SQL Server 2019 Linux container image from Microsoft Container Registry.

   sudo docker pull mcr.microsoft.com/mssql/server:2019-latest
   

   Nota

   Si usa PowerShell Core, reemplace las comillas dobles por comillas simples.If you are using PowerShell Core, replace the double quotes with single quotes.

   docker pull mcr.microsoft.com/mssql/server:2019-latest
   

   docker pull mcr.microsoft.com/mssql/server:2019-latest
   

   Sugerencia

   En este inicio rápido se usa la imagen de Docker de SQL Server 2019.This quickstart uses the SQL Server 2019 Docker image. Si quiere ejecutar la imagen de SQL Server 2017, vea la versión de SQL Server 2017 de este artículo.If you want to run the SQL Server 2017 image, see the SQL Server 2017 version of this article.

   El comando anterior extrae la imagen de contenedor de SQL Server 2019 basada en Ubuntu.The previous command pulls the SQL Server 2019 container image based on Ubuntu. Para usar en su lugar imágenes de contenedor basadas en RedHat, vea Ejecución de imágenes de contenedor basadas en RHEL.To instead use container images based on RedHat, see Run RHEL-based container images. Para ver todas las imágenes disponibles, vea la página mssql-server-linux de Docker Hub.To see all available images, see the mssql-server-linux Docker hub page.

   En los comandos de Bash de este artículo se usa sudo.For the bash commands in this article, sudo is used. En macOS, es posible que no se necesite sudo.On macOS, sudo might not be required. En Linux, si no quiere usar sudo para ejecutar Docker, puede configurar un grupo de Docker y agregarle usuarios.On Linux, if you do not want to use sudo to run Docker, you can configure a docker group and add users to that group. Para obtener más información, vea Pasos posteriores a la instalación para Linux.For more information, see Post-installation steps for Linux.

2. Para ejecutar la imagen de contenedor con Docker, puede usar el siguiente comando desde un shell de Bash (Linux y macOS), o bien una línea de comandos de PowerShell con privilegios elevados.To run the container image with Docker, you can use the following command from a bash shell (Linux/macOS) or elevated PowerShell command prompt.

   sudo docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" \
      -p 1433:1433 --name sql1 -h sql1 \
      -d mcr.microsoft.com/mssql/server:2019-latest
   

   docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" `
      -p 1433:1433 --name sql1 -h sql1 `
      -d mcr.microsoft.com/mssql/server:2019-latest
   

   docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" `
      -p 1433:1433 --name sql1 -h sql1 `
      -d mcr.microsoft.com/mssql/server:2019-latest
   

   Nota

   La contraseña debe seguir la directiva de contraseñas predeterminada de SQL Server. En caso contrario, el contenedor no podrá instalar SQL Server y dejará de funcionar.The password should follow the SQL Server default password policy, otherwise the container can not setup SQL server and will stop working. De forma predeterminada, la contraseña debe tener al menos 8 caracteres y contener caracteres de tres de los cuatro conjuntos siguientes: Letras mayúsculas, letras minúsculas, dígitos de Base 10 y símbolos.By default, the password must be at least 8 characters long and contain characters from three of the following four sets: Uppercase letters, Lowercase letters, Base 10 digits, and Symbols. Puede examinar el registro de errores ejecutando el comando docker logs.You can examine the error log by executing the docker logs command.

   De forma predeterminada, se creará un contenedor con la edición para desarrolladores de SQL Server 2019.By default, this creates a container with the Developer edition of SQL Server 2019.

   En la tabla siguiente, se proporciona una descripción de los parámetros del ejemplo de docker run anterior:The following table provides a description of the parameters in the previous docker run example:

   ParámetroParameter	DescripciónDescription
   -e "ACCEPT_EULA=Y"-e "ACCEPT_EULA=Y"	Establezca la variable ACCEPT_EULA en cualquier valor para confirmar que acepta el Contrato de licencia de usuario final.Set the ACCEPT_EULA variable to any value to confirm your acceptance of the End-User Licensing Agreement. Configuración requerida para la imagen de SQL Server.Required setting for the SQL Server image.
   -e "SA_PASSWORD=<YourStrong@Passw0rd\>"-e "SA_PASSWORD=<YourStrong@Passw0rd\>"	Especifique una contraseña segura propia con al menos 8 caracteres y que cumpla los requisitos de contraseña de SQL Server.Specify your own strong password that is at least 8 characters and meets the SQL Server password requirements. Configuración requerida para la imagen de SQL Server.Required setting for the SQL Server image.
   -p 1433:1433-p 1433:1433	Asigne un puerto TCP en el entorno de host (el primer valor) a un puerto TCP en el contenedor (el segundo valor).Map a TCP port on the host environment (first value) with a TCP port in the container (second value). En este ejemplo, SQL Server escucha en TCP 1433 en el contenedor y se expone al puerto 1433 del host.In this example, SQL Server is listening on TCP 1433 in the container and this is exposed to the port, 1433, on the host.
   --name sql1--name sql1	Especifique un nombre personalizado para el contenedor en lugar de uno generado aleatoriamente.Specify a custom name for the container rather than a randomly generated one. Si ejecuta más de un contenedor, no podrá usar el mismo nombre.If you run more than one container, you cannot reuse this same name.
   -h sql1-h sql1	Cuando se usa para establecer explícitamente el nombre de host del contenedor, si no se especifica, el valor predeterminado es el identificador del contenedor, que es un GUID del sistema generado aleatoriamente.Used to explicitly set the container hostname, if you don't specify it, it defaults to the container ID which is a randomly generated system GUID.
   mcr.microsoft.com/mssql/server:2019-latestmcr.microsoft.com/mssql/server:2019-latest	Imagen de contenedor de Ubuntu Linux de SQL Server 2019.The SQL Server 2019 Ubuntu Linux container image.

3. Para ver los contenedores de Docker, use el comando docker ps.To view your Docker containers, use the docker ps command.

   sudo docker ps -a
   

   docker ps -a
   

   docker ps -a
   

   Debería ver un resultado similar al de la captura de pantalla siguiente:You should see output similar to the following screenshot:

   

4. Si la columna ESTADO muestra el estado Activo, esto indica que SQL Server se está ejecutando en el contenedor y que está escuchando en el puerto especificado en la columna PUERTOS.If the STATUS column shows a status of Up, then SQL Server is running in the container and listening on the port specified in the PORTS column. Si en la columna ESTADO del contenedor de SQL Server se muestra Cerrado, vea Solución de problemas de contenedores de Docker de SQL Server.If the STATUS column for your SQL Server container shows Exited, see Troubleshooting SQL Server Docker containers.

El parámetro -h (nombre de host), tal y como se indicó anteriormente, cambia el nombre interno del contenedor a un valor personalizado.The -h (host name) parameter as discussed above, changes the internal name of the container to a custom value. Esto cambia el nombre interno del contenedor a un valor personalizado.This changes the internal name of the container to a custom value. Este es el nombre que verá que se devuelve en la siguiente consulta de Transact-SQL:This is the name you'll see returned in the following Transact-SQL query:

SELECT @@SERVERNAME,
    SERVERPROPERTY('ComputerNamePhysicalNetBIOS'),
    SERVERPROPERTY('MachineName'),
    SERVERPROPERTY('ServerName')

Establecer -h y --name en el mismo valor es una buena manera de identificar fácilmente el contenedor de destino.Setting -h and --name to the same value is a good way to easily identify the target container.

5. Como paso final, cambie la contraseña de administrador del sistema porque SA_PASSWORD se ve en la salida de ps -eax y se almacena en la variable de entorno con el mismo nombre.As a final step, change your SA password because the SA_PASSWORD is visible in ps -eax output and stored in the environment variable of the same name. Vea los pasos siguientes.See steps below.

sudo docker stop sql1
sudo docker rm sql1

docker stop sql1
docker rm sql1

docker stop sql1
docker rm sql1