Skip to content

Commit 4b6f7e3

Browse files
authored
Merge pull request #29531 from MicrosoftDocs/main
1/10/2024 PM Publish
2 parents 9989da9 + e43a3d0 commit 4b6f7e3

10 files changed

Lines changed: 110 additions & 62 deletions

docs/linux/quickstart-install-connect-docker.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: This quickstart shows how to use Docker to run the SQL Server Linux
44
author: amitkh-msft
55
ms.author: amitkh
66
ms.reviewer: vanto, randolphwest
7-
ms.date: 10/24/2023
7+
ms.date: 01/10/2024
88
ms.service: sql
99
ms.subservice: linux
1010
ms.topic: quickstart
@@ -22,7 +22,7 @@ monikerRange: ">=sql-server-linux-2017 || >=sql-server-2017"
2222
<!--SQL Server 2017 on Linux-->
2323
::: moniker range="= sql-server-linux-2017 || = sql-server-2017"
2424

25-
In this quickstart, you'll use Docker to pull and run the [!INCLUDE [sssql17-md](../includes/sssql17-md.md)] Linux container image, [mssql-server-linux](https://hub.docker.com/_/microsoft-mssql-server). Then you can connect with **sqlcmd** to create your first database and run queries.
25+
In this quickstart, you'll use Docker to pull and run the [!INCLUDE [sssql17-md](../includes/sssql17-md.md)] Linux container image, [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about). Then you can connect with **sqlcmd** to create your first database and run queries.
2626

2727
For more information on supported platforms, see [Release notes for SQL Server 2017 on Linux](sql-server-linux-release-notes-2017.md).
2828

@@ -33,7 +33,7 @@ For more information on supported platforms, see [Release notes for SQL Server 2
3333
<!--SQL Server 2019 on Linux-->
3434
::: moniker range="= sql-server-linux-ver15 || = sql-server-ver15"
3535

36-
In this quickstart, you'll use Docker to pull and run the [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] Linux container image, [mssql-server-linux](https://hub.docker.com/_/microsoft-mssql-server). Then you can connect with **sqlcmd** to create your first database and run queries.
36+
In this quickstart, you'll use Docker to pull and run the [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] Linux container image, [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about). Then you can connect with **sqlcmd** to create your first database and run queries.
3737

3838
For more information on supported platforms, see [Release notes for SQL Server 2019 on Linux](sql-server-linux-release-notes-2019.md).
3939

@@ -44,7 +44,7 @@ For more information on supported platforms, see [Release notes for SQL Server 2
4444
<!--SQL Server 2022 on Linux-->
4545
::: moniker range=">= sql-server-linux-ver16 || >= sql-server-ver16"
4646

47-
In this quickstart, you'll use Docker to pull and run the [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] Linux container image, [mssql-server-linux](https://hub.docker.com/_/microsoft-mssql-server). Then you can connect with **sqlcmd** to create your first database and run queries.
47+
In this quickstart, you'll use Docker to pull and run the [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] Linux container image, [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about). Then you can connect with **sqlcmd** to create your first database and run queries.
4848

4949
For more information on supported platforms, see [Release notes for [!INCLUDE [sssql22](../includes/sssql22-md.md)] on Linux](sql-server-linux-release-notes-2022.md).
5050

@@ -107,7 +107,7 @@ Before starting the following steps, make sure that you've selected your preferr
107107
> [!TIP]
108108
> This quickstart creates [!INCLUDE [sssql17-md](../includes/sssql17-md.md)] containers. If you prefer to create Linux containers for different versions of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [[!INCLUDE [sssql19-md](../includes/sssql19-md.md)]](quickstart-install-connect-docker.md?view=sql-server-linux-ver15&preserve-view=true#pullandrun2019) or [[!INCLUDE [sssql22-md](../includes/sssql22-md.md)]](quickstart-install-connect-docker.md?view=sql-server-linux-ver16&preserve-view=true#pullandrun2022) versions of this article.
109109
110-
The previous command pulls the latest [!INCLUDE [sssql17-md](../includes/sssql17-md.md)] Linux container image. If you want to pull a specific image, you add a colon and the tag name, such as `mcr.microsoft.com/mssql/server:2017-GA-ubuntu`. To see all available images, see [the mssql-server Docker hub page](https://hub.docker.com/r/microsoft/mssql-server).
110+
The previous command pulls the latest [!INCLUDE [sssql17-md](../includes/sssql17-md.md)] Linux container image. If you want to pull a specific image, you add a colon and the tag name, such as `mcr.microsoft.com/mssql/server:2017-GA-ubuntu`. To see all available images, see the [Microsoft Artifact Registry](https://mcr.microsoft.com/product/mssql/server/about).
111111

112112
::: zone pivot="cs1-bash"
113113
For the bash commands in this article, `sudo` is used. If you don't want to use `sudo` to run Docker, you can configure a `docker` group and add users to that group. For more information, see [Post-installation steps for Linux](https://docs.docker.com/install/linux/linux-postinstall/).
@@ -260,7 +260,7 @@ Before starting the following steps, make sure that you've selected your preferr
260260
> [!TIP]
261261
> This quickstart creates [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] containers. If you prefer to create Linux containers for different versions of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [[!INCLUDE [sssql17-md](../includes/sssql17-md.md)]](quickstart-install-connect-docker.md?view=sql-server-linux-2017&preserve-view=true#pullandrun2017) or [[!INCLUDE [sssql22-md](../includes/sssql22-md.md)]](quickstart-install-connect-docker.md?view=sql-server-linux-ver16&preserve-view=true#pullandrun2022) versions of this article.
262262
263-
The previous command pulls the latest [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] Linux container image. If you want to pull a specific image, you add a colon and the tag name, such as `mcr.microsoft.com/mssql/server:2019-GA-ubuntu`. To see all available images, see [the mssql-server Docker hub page](https://hub.docker.com/r/microsoft/mssql-server).
263+
The previous command pulls the latest [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] Linux container image. If you want to pull a specific image, you add a colon and the tag name, such as `mcr.microsoft.com/mssql/server:2019-GA-ubuntu`. To see all available images, see the [Microsoft Artifact Registry](https://mcr.microsoft.com/product/mssql/server/about).
264264

265265
::: zone pivot="cs1-bash"
266266
For the bash commands in this article, `sudo` is used. If you don't want to use `sudo` to run Docker, you can configure a `docker` group and add users to that group. For more information, see [Post-installation steps for Linux](https://docs.docker.com/install/linux/linux-postinstall/).
@@ -413,7 +413,7 @@ Before starting the following steps, make sure that you've selected your preferr
413413
> [!TIP]
414414
> This quickstart creates [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] containers. If you prefer to create Linux containers for different versions of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [[!INCLUDE [sssql17-md](../includes/sssql17-md.md)]](quickstart-install-connect-docker.md?view=sql-server-linux-2017&preserve-view=true#pullandrun2017) or [[!INCLUDE [sssql19-md](../includes/sssql19-md.md)]](quickstart-install-connect-docker.md?view=sql-server-linux-ver15&preserve-view=true#pullandrun2019) versions of this article.
415415
416-
The previous command pulls the latest [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] Linux container image. If you want to pull a specific image, you add a colon and the tag name, such as `mcr.microsoft.com/mssql/server:2022-GA-ubuntu`. To see all available images, see [the mssql-server Docker hub page](https://hub.docker.com/r/microsoft/mssql-server).
416+
The previous command pulls the latest [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] Linux container image. If you want to pull a specific image, you add a colon and the tag name, such as `mcr.microsoft.com/mssql/server:2022-GA-ubuntu`. To see all available images, see the [Microsoft Artifact Registry](https://mcr.microsoft.com/product/mssql/server/about).
417417

418418
::: zone pivot="cs1-bash"
419419
For the bash commands in this article, `sudo` is used. If you don't want to use `sudo` to run Docker, you can configure a `docker` group and add users to that group. For more information, see [Post-installation steps for Linux](https://docs.docker.com/install/linux/linux-postinstall/).

docs/linux/quickstart-sql-server-containers-azure.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Quickstart: Deploy a SQL Server container cluster on Azure"
33
description: This tutorial shows how to deploy a SQL Server high availability solution with Azure Kubernetes Service or Azure Red Hat OpenShift.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: 07/31/2023
6+
ms.date: 01/10/2024
77
ms.service: sql
88
ms.subservice: linux
99
ms.topic: quickstart
@@ -259,7 +259,7 @@ For a database in an OpenShift cluster, you must use persisted storage. You can
259259

260260
The container hosting the SQL Server instance is described as a Kubernetes *deployment object*. The deployment creates a *replica set*. The replica set creates the *pod*.
261261

262-
You create a manifest to describe the container, based on the SQL Server [mssql-server-linux](https://hub.docker.com/_/microsoft-mssql-server) Docker image.
262+
You create a manifest to describe the container, based on the SQL Server [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about) Docker image.
263263

264264
- The manifest references the `mssql-server` persistent volume claim, and the `mssql` secret that you already applied to the Kubernetes cluster.
265265
- The manifest also describes a [service](https://kubernetes.io/docs/concepts/services-networking/service/). This service is a load balancer. The load balancer guarantees that the IP address persists after SQL Server instance is recovered.
@@ -376,7 +376,7 @@ You create a manifest to describe the container, based on the SQL Server [mssql-
376376
mssql-deployment-3813464711-h312s 1/1 Running 0 17m
377377
```
378378

379-
The pod has a status of `Running`. This status indicates that the container is ready. After the deployment is created, it can take a few minutes before the pod is visible. The delay is because the cluster pulls the [mssql-server-linux](https://hub.docker.com/_/microsoft-mssql-server) image from Docker hub. After the image is pulled the first time, subsequent deployments might be faster if the deployment is to a node that already has the image cached on it.
379+
The pod has a status of `Running`. This status indicates that the container is ready. After the deployment is created, it can take a few minutes before the pod is visible. The delay is because the cluster pulls the [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about) image from the Microsoft Artifact Registry. After the image is pulled the first time, subsequent deployments might be faster if the deployment is to a node that already has the image cached on it.
380380

381381
1. Verify the services are running. Run the following command:
382382

@@ -414,7 +414,7 @@ You create a manifest to describe the container, based on the SQL Server [mssql-
414414

415415
The container hosting the SQL Server instance is described as an OpenShift *deployment object*. The deployment creates a *replica set*. The replica set creates the *pod*.
416416

417-
You create a manifest to describe the container, based on the SQL Server [mssql-server-linux](https://hub.docker.com/_/microsoft-mssql-server) Docker image.
417+
You create a manifest to describe the container, based on the SQL Server [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about) Docker image.
418418

419419
- The manifest references the `mssql-server` persistent volume claim, and the `mssql` secret that you already applied to the OpenShift cluster.
420420
- The manifest also describes a [service](https://docs.openshift.com/container-platform/4.12/networking/understanding-networking.html). This service is a load balancer. The load balancer guarantees that the IP address persists after SQL Server instance is recovered.
@@ -535,7 +535,7 @@ You create a manifest to describe the container, based on the SQL Server [mssql-
535535
mssql-deployment-3813464711-h312s 1/1 Running 0 17m
536536
```
537537

538-
The pod has a status of `Running`. This status indicates that the container is ready. After the deployment is created, it can take a few minutes before the pod is visible. The delay is because the cluster pulls the [mssql-server-linux](https://hub.docker.com/_/microsoft-mssql-server) image from Docker hub. After the image is pulled the first time, subsequent deployments might be faster if the deployment is to a node that already has the image cached on it.
538+
The pod has a status of `Running`. This status indicates that the container is ready. After the deployment is created, it can take a few minutes before the pod is visible. The delay is because the cluster pulls the [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about) image from the Microsoft Artifact Registry. After the image is pulled the first time, subsequent deployments might be faster if the deployment is to a node that already has the image cached on it.
539539

540540
1. Verify the services are running. Run the following command:
541541

docs/linux/sql-server-linux-docker-container-deployment.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Explore how SQL Server can be deployed on Linux containers and lear
44
author: amitkh-msft
55
ms.author: amitkh
66
ms.reviewer: vanto, randolphwest
7-
ms.date: 07/11/2023
7+
ms.date: 01/10/2024
88
ms.service: sql
99
ms.subservice: linux
1010
ms.topic: conceptual
@@ -253,7 +253,7 @@ Packages
253253
254254
There are scenarios where you might not want to use the latest SQL Server container image. To run a specific SQL Server container image, use the following steps:
255255

256-
1. Identify the Docker `tag` for the release you want to use. To view the available tags, see [the mssql-server-linux Docker hub page](https://hub.docker.com/_/microsoft-mssql-server).
256+
1. Identify the Docker `tag` for the release you want to use. To view the available tags, see the [Microsoft Artifact Registry](https://mcr.microsoft.com/product/mssql/server/tags).
257257

258258
1. Pull the SQL Server container image with the tag. For example, to pull the `2019-CU18-ubuntu-20.04` image, replace `<image_tag>` in the following command with `2019-CU18-ubuntu-20.04`.
259259

@@ -329,7 +329,7 @@ docker pull mcr.microsoft.com/mssql/rhel/server:2019-CU18-rhel-8.4
329329

330330
## <a id="production"></a> Run production container images
331331

332-
The [quickstart](quickstart-install-connect-docker.md) in the previous section runs the free Developer edition of SQL Server from Docker Hub. Most of the information still applies if you want to run production container images, such as Enterprise, Standard, or Web editions. However, there are a few differences that are outlined here.
332+
The [quickstart](quickstart-install-connect-docker.md) in the previous section runs the free Developer edition of SQL Server from the Microsoft Artifact Registry. Most of the information still applies if you want to run production container images, such as Enterprise, Standard, or Web editions. However, there are a few differences that are outlined here.
333333

334334
- You can only use SQL Server in a production environment if you have a valid license. You can obtain a free SQL Server Express production license [here](https://go.microsoft.com/fwlink/?linkid=857693). SQL Server Standard and Enterprise edition licenses are available through [Microsoft Volume Licensing](https://www.microsoft.com/licensing/default.aspx).
335335

docs/linux/sql-server-linux-overview.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Overview of SQL Server on Linux
33
description: This article describes how SQL Server runs on Linux and provides information on how to learn more.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: 10/27/2023
6+
ms.date: 01/10/2024
77
ms.service: sql
88
ms.subservice: linux
99
ms.topic: conceptual
@@ -47,8 +47,8 @@ To get started, install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md
4747

4848
The [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container images are published and available on the Microsoft Container Registry (MCR), and also cataloged at the following locations, based on the operating system image that was used when creating the container image:
4949

50-
- For RHEL-based [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container images, see [SQL Server Red Hat Containers](https://catalog.redhat.com/software/containers/mssql/rhel/server/61f2f612f385723914ed60bc).
51-
- For Ubuntu-based [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] images, see [SQL Server on Docker Hub](https://hub.docker.com/_/microsoft-mssql-server).
50+
- For both RHEL and Ubuntu based [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container images, see [SQL Server on the Microsoft Artifact Registry](https://mcr.microsoft.com/product/mssql/server/about).
51+
- For RHEL-based [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container images, see [SQL Server Red Hat containers](https://catalog.redhat.com/software/containers/mssql/rhel/server/61f2f612f385723914ed60bc).
5252

5353
> [!NOTE]
5454
> Containers will only be published to MCR for the *most recent* Linux distributions. If you create your own custom [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container image for an older supported distribution, it will still be supported. For more information, see [Upcoming updates to SQL Server container images on Microsoft Artifact Registry aka (MCR)](https://techcommunity.microsoft.com/t5/sql-server-blog/upcoming-updates-to-sql-server-container-images-on-microsoft/ba-p/3573013).

docs/linux/sql-server-linux-whats-new-2019.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: What's New for SQL Server 2019 on Linux
33
description: This article highlights what's new for SQL Server 2019 on Linux.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: 11/22/2021
6+
ms.date: 01/10/2024
77
ms.service: sql
88
ms.subservice: linux
99
ms.topic: conceptual
@@ -45,7 +45,7 @@ The updates have been made in SQL Server 2019 on Linux:
4545
|`tempdb` improvements | By default, a new installation of SQL Server on Linux creates multiple `tempdb` data files based on the number of logical cores (with up to 8 data files). This does not apply to in-place minor or major version upgrades. Each `tempdb` file is 8 MB with an auto growth of 64 MB. This behavior is similar to the default SQL Server installation on Windows. |
4646
| PolyBase on Linux | [Install PolyBase](../relational-databases/polybase/polybase-linux-setup.md) on Linux for non-Hadoop connectors.<br/><br/>[PolyBase type mapping](../relational-databases/polybase/polybase-type-mapping.md). |
4747
| Change Data Capture (CDC) support | Change Data Capture (CDC) is now supported on Linux for SQL Server 2019. |
48-
| Microsoft Container Registry | The [Microsoft Container Registry](https://azure.microsoft.com/blog/microsoft-syndicates-container-catalog/) now replaces Docker Hub for new official Microsoft container images, including [!INCLUDE[sql-server-2019](../includes/sssql19-md.md)]. |
48+
| Microsoft Container Registry | The [Microsoft Container Registry](https://azure.microsoft.com/blog/microsoft-syndicates-container-catalog/) replaces Docker Hub for official Microsoft container images, including [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. |
4949
| Non-root containers | [!INCLUDE[sql-server-2019](../includes/sssql19-md.md)] introduces the ability to create safer containers by starting the [!INCLUDE[sql-server](../includes/ssnoversion-md.md)] process as a non-root user by default. See [build and run SQL Server containers as a non-root user](./sql-server-linux-docker-container-security.md#buildnonrootcontainer) for more details. |
5050

5151
## Related content

0 commit comments

Comments
 (0)