Skip to content

Commit 989140b

Browse files
authored
Merge pull request #206001 from tomvcassidy/ubuntu16.04Remove
Removing References to Ubuntu 16.04
2 parents ff29185 + 0a3afbb commit 989140b

10 files changed

+51
-64
lines changed

articles/service-fabric/service-fabric-cluster-creation-via-arm.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ If you are creating a production cluster to run production workloads, we recomme
2626
[!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
2727

2828
## Prerequisites
29-
In this article, use the Service Fabric RM powershell or Azure CLI modules to deploy a cluster:
29+
In this article, use the Service Fabric RM PowerShell or Azure CLI modules to deploy a cluster:
3030

3131
* [Azure PowerShell 4.1 and above][azure-powershell]
3232
* [Azure CLI version 2.0 and above][azure-CLI]
@@ -60,7 +60,7 @@ You can use either the following PowerShell or Azure CLI commands to create a cl
6060
The default template used is available here for [Windows](https://github.com/Azure-Samples/service-fabric-cluster-templates/tree/master/5-VM-Windows-1-NodeTypes-Secure-NSG)
6161
and here for [Ubuntu](https://github.com/Azure-Samples/service-fabric-cluster-templates/tree/master/5-VM-Ubuntu-1-NodeTypes-Secure).
6262

63-
The following commands can create either Windows or Linux clusters, depending on how specify the OS parameter. Both PowerShell/CLI commands output the certificate in the specified *CertificateOutputFolder* (make sure the certificate folder location you specify already exists before running the command!).
63+
The following commands can create either Windows or Linux clusters, depending on how you specify the OS parameter. Both PowerShell/CLI commands output the certificate in the specified *CertificateOutputFolder* (make sure the certificate folder location you specify already exists before running the command!).
6464

6565
> [!NOTE]
6666
> The following PowerShell command only works with the Azure PowerShell `Az` module. To check the current version of Azure Resource Manager PowerShell version, run the following PowerShell command "Get-Module Az". Follow [this link](/powershell/azure/install-Az-ps) to upgrade your Azure Resource Manager PowerShell version.
@@ -93,7 +93,7 @@ declare CertSubjectName="mylinux.westus.cloudapp.azure.com"
9393
declare vmpassword="Password!1"
9494
declare certpassword="Password!4321"
9595
declare vmuser="myadmin"
96-
declare vmOs="UbuntuServer1604"
96+
declare vmOs="UbuntuServer1804"
9797
declare certOutputFolder="c:\certificates"
9898
9999
az sf cluster create --resource-group $resourceGroupName --location $resourceGroupLocation \
@@ -159,7 +159,7 @@ You can use the following command to specify an existing certificate to create a
159159

160160
If this is a CA signed certificate that you will end up using for other purposes as well, then it is recommended that you provide a distinct resource group specifically for your key vault. We recommend that you put the key vault into its own resource group. This action lets you remove the compute and storage resource groups, including the resource group that contains your Service Fabric cluster, without losing your keys and secrets. **The resource group that contains your key vault *must be in the same region* as the cluster that is using it.**
161161

162-
### Use the default five node, one node type template that ships in the module
162+
### Use the default five nodes, one node type template that ships in the module
163163

164164
The default template used is available here for [Windows](https://github.com/Azure-Samples/service-fabric-cluster-templates/tree/master/5-VM-Windows-1-NodeTypes-Secure-NSG)
165165
and here for [Ubuntu](https://github.com/Azure-Samples/service-fabric-cluster-templates/tree/master/5-VM-Ubuntu-1-NodeTypes-Secure).
@@ -190,7 +190,7 @@ declare resourceGroupName="mylinux"
190190
declare vaultResourceGroupName="myvaultrg"
191191
declare vaultName="myvault"
192192
declare certificate-file="c:\certificates\mycert.pem"
193-
declare vmOs="UbuntuServer1604"
193+
declare vmOs="UbuntuServer1804"
194194
195195
az sf cluster create --resource-group $resourceGroupName --location $resourceGroupLocation \
196196
--certificate-file $certificate-file --certificate-password $certPassword \

articles/service-fabric/service-fabric-cluster-upgrade-os.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,18 +11,18 @@ ms.date: 07/14/2022
1111

1212
# Upgrade Linux OS for Azure Service Fabric
1313

14-
This document describes how to migrate your Azure Service Fabric for Linux cluster from Ubuntu version 16.04 LTS to 18.04 LTS. Each operating system (OS) version requires a different Service Fabric runtime package. This article describes the steps required to facilitate a smooth migration to the newer version.
14+
This document describes how to migrate your Azure Service Fabric for Linux cluster from Ubuntu version 18.04 LTS to 20.04 LTS. Each operating system (OS) version requires a different Service Fabric runtime package. This article describes the steps required to facilitate a smooth migration to the newer version.
1515

1616
## Approach to migration
1717

1818
The general approach to the migration follows these steps:
1919

20-
1. Switch the Service Fabric cluster Azure Resource Manager resource `vmImage` to `Ubuntu18_04`. This setting pulls future code upgrades for this OS version. This temporary OS mismatch against existing node types blocks automatic code upgrade rollouts to ensure safe rollover.
20+
1. Switch the Service Fabric cluster Azure Resource Manager resource `vmImage` to `Ubuntu20_04`. This setting pulls future code upgrades for this OS version. This temporary OS mismatch against existing node types blocks automatic code upgrade rollouts to ensure safe rollover.
2121

2222
> [!TIP]
2323
> Avoid issuing manual Service Fabric cluster code upgrades during the OS migration. Doing so may cause the old node type nodes to enter a state that requires human intervention.
2424
25-
1. For each node type in the cluster, create another node type that targets the Ubuntu 18.04 OS image for the underlying Virtual Machine Scale Set. Each new node type assumes the role of its old counterpart.
25+
1. For each node type in the cluster, create another node type that targets the Ubuntu 20.04 OS image for the underlying Virtual Machine Scale Set. Each new node type assumes the role of its old counterpart.
2626

2727
* A new primary node type has to be created to replace the old node type marked as `isPrimary: true`.
2828
* For each non-primary node type, these nodes types are marked `isPrimary: false`.
@@ -48,7 +48,7 @@ This procedure demonstrates how to quickly prototype the node type migration by
4848
$resourceGroup="Group1"
4949
$clusterName="Contoso01SFCluster"
5050
# Update cluster vmImage to target OS. This registers the SF runtime package type that is supplied for upgrades.
51-
Update-AzServiceFabricVmImage -ResourceGroupName $resourceGroup -ClusterName $clusterName -VmImage Ubuntu18_04
51+
Update-AzServiceFabricVmImage -ResourceGroupName $resourceGroup -ClusterName $clusterName -VmImage Ubuntu20_04
5252
```
5353
5454
2. Add new node type counterpart for each of the existing node types:

articles/service-fabric/service-fabric-get-started-linux.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@ For manual installation of the Service Fabric runtime and common SDK, follow the
8888
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
8989
```
9090

91-
6. Add Azul JDK Key to your APT keyring and setup its repository.
91+
6. Add Azul JDK Key to your APT keyring and set up its repository.
9292

9393
```bash
9494
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 0xB1998361219BD9C9
@@ -195,16 +195,12 @@ Start a container-based [Service Fabric Onebox](https://hub.docker.com/_/microso
195195
```bash
196196
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u20
197197
```
198+
198199
<b>Ubuntu 18.04 LTS:</b>
199200
```bash
200201
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18
201202
```
202203

203-
<b>Ubuntu 16.04 LTS:</b>
204-
```bash
205-
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u16
206-
```
207-
208204
>[!TIP]
209205
> By default, this will pull the image with the latest version of Service Fabric. For particular revisions, please visit the [Docker Hub](https://hub.docker.com/r/microsoft/service-fabric-onebox/) page.
210206

articles/service-fabric/service-fabric-get-started-mac.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -14,16 +14,16 @@ ms.date: 07/14/2022
1414
# service-fabric-local-linux-cluster-windows.md
1515
---
1616

17-
# Set up your development environment on Mac OS X
17+
# Set up your development environment on macOS X
1818
> [!div class="op_single_selector"]
1919
> * [Windows](service-fabric-get-started.md)
2020
> * [Linux](service-fabric-get-started-linux.md)
21-
> * [Mac OS X](service-fabric-get-started-mac.md)
21+
> * [macOS X](service-fabric-get-started-mac.md)
2222
23-
You can build Azure Service Fabric applications to run on Linux clusters by using Mac OS X. This document covers how to set up your Mac for development.
23+
You can build Azure Service Fabric applications to run on Linux clusters by using macOS X. This document covers how to set up your Mac for development.
2424

2525
## Prerequisites
26-
Azure Service Fabric doesn't run natively on Mac OS X. To run a local Service Fabric cluster, a pre-configured Docker container image is provided. Before you get started, you'll need:
26+
Azure Service Fabric doesn't run natively on macOS X. To run a local Service Fabric cluster, a pre-configured Docker container image is provided. Before you get started, you'll need:
2727

2828
* The system requirements for installing [Docker Desktop on Mac](https://docs.docker.com/docker-for-mac/install/)
2929

@@ -56,14 +56,14 @@ To set up a local Docker container and have a Service Fabric cluster running on
5656
>We recommend increasing the resources allocated to Docker when testing large applications. This can be done by selecting the **Docker Icon**, then selecting **Advanced** to adjust the number of cores and memory.
5757

5858
2. Start the cluster.<br/>
59-
<b>Ubuntu 18.04 LTS:</b>
59+
<b>Ubuntu 20.04 LTS:</b>
6060
```bash
61-
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18
61+
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u20
6262
```
6363

64-
<b>Ubuntu 16.04 LTS:</b>
64+
<b>Ubuntu 18.04 LTS:</b>
6565
```bash
66-
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u16
66+
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18
6767
```
6868

6969
>[!TIP]
@@ -147,14 +147,14 @@ sfctl cluster select --endpoint http://localhost:19080
147147

148148
Service Fabric provides scaffolding tools that help you to create a Service Fabric application from the terminal by using the Yeoman template generator. Use the following steps to ensure that the Service Fabric Yeoman template generator is working on your machine:
149149

150-
1. Node.js and Node Package Manager (NPM) must be installed on your Mac. The software can be installed by using [HomeBrew](https://brew.sh/), as follows:
150+
1. Node.js and Node Package Manager must be installed on your Mac. The software can be installed by using [HomeBrew](https://brew.sh/), as follows:
151151

152152
```bash
153153
brew install node
154154
node -v
155155
npm -v
156156
```
157-
2. Install the [Yeoman](https://yeoman.io/) template generator on your machine from NPM:
157+
2. Install the [Yeoman](https://yeoman.io/) template generator on your machine from Node Package Manager:
158158

159159
```bash
160160
npm install -g yo

articles/service-fabric/service-fabric-how-to-publish-linux-app-vs.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Create and Publish a.Net Core app to a remote Linux Cluster
3-
description: Create and publish .Net Core apps targeting a remote Linux cluster from Visual Studio
2+
title: Create and Publish a .NET Core app to a remote Linux Cluster
3+
description: Create and publish .NET Core apps targeting a remote Linux cluster from Visual Studio
44
ms.topic: how-to
55
ms.author: tomcassidy
66
author: tomvcassidy
@@ -9,26 +9,26 @@ services: service-fabric
99
ms.date: 07/14/2022
1010
---
1111

12-
# Use Visual Studio to create and publish .Net Core applications targeting a remote Linux Service Fabric cluster
13-
With Visual Studio tooling you can develop and publish Service Fabric .Net Core applications targeting a Linux Service Fabric cluster. The SDK version must be 3.4 or above to deploy a .Net Core application targeting Linux Service Fabric clusters from Visual Studio.
12+
# Use Visual Studio to create and publish .NET Core applications targeting a remote Linux Service Fabric cluster
13+
With Visual Studio tooling you can develop and publish Service Fabric .NET Core applications targeting a Linux Service Fabric cluster. The SDK version must be 3.4 or above to deploy a .NET Core application targeting Linux Service Fabric clusters from Visual Studio.
1414

1515
> [!Note]
1616
> Visual Studio doesn't support debugging Service Fabric applications which target Linux.
1717
>
1818
19-
## Create a Service Fabric application targeting .Net Core
19+
## Create a Service Fabric application targeting .NET Core
2020
1. Launch Visual Studio as an **administrator**.
2121
2. Create a project with **File->New->Project**.
2222
3. In the **New Project** dialog, choose **Cloud -> Service Fabric Application**.
2323
![create-application]
2424
4. Name the application and click **Ok**.
25-
5. On the **New Service Fabric Service** page, select the type of service you would like to create under the **.Net Core Section**.
25+
5. On the **New Service Fabric Service** page, select the type of service you would like to create under the **.NET Core Section**.
2626
![create-service]
2727

2828
## Deploy to a remote Linux cluster
2929
1. In the solution explorer, right click on the application and select **Build**.
3030
![build-application]
31-
2. Once the build process for the application has completed, right click on the service and select edit the **csproj file**.
31+
2. Once the build process for the application has completed, right click on the service and choose to edit the **csproj file**.
3232
![edit-csproj]
3333
3. Edit the UpdateServiceFabricManifestEnabled property from True to **False** if the service is an **actor project type**. If your application does not have an actor service, skip to step 4.
3434
```xml
@@ -40,7 +40,7 @@ With Visual Studio tooling you can develop and publish Service Fabric .Net Core
4040
4141
4. Update the RuntimeIndetifier from win7-x64 to the target platform in the service project.
4242
```xml
43-
<RuntimeIdentifier>ubuntu.16.04-x64</RuntimeIdentifier>
43+
<RuntimeIdentifier>ubuntu.20.04-x64</RuntimeIdentifier>
4444
```
4545
5. In the ServiceManifest, update the entrypoint program to remove .exe.
4646
```xml
@@ -62,4 +62,4 @@ With Visual Studio tooling you can develop and publish Service Fabric .Net Core
6262
[publish-application]:./media/service-fabric-how-to-vs-remote-linux-cluster/publish-remote-linux.png
6363

6464
## Next steps
65-
* Learn about [Getting started with Service Fabric with .Net Core](https://azure.microsoft.com/resources/samples/service-fabric-dotnet-core-getting-started/)
65+
* Learn about [Getting started with Service Fabric with .NET Core](https://azure.microsoft.com/resources/samples/service-fabric-dotnet-core-getting-started/)

articles/service-fabric/service-fabric-local-linux-cluster-windows.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -51,14 +51,14 @@ To set up a local Docker container and have a Service Fabric cluster running on
5151
* Apply & Restart - restart the Docker daemon for the changes to take effect.
5252

5353
2. Start the cluster via PowerShell.<br/>
54-
<b>Ubuntu 18.04 LTS:</b>
55-
```powershell
56-
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18
54+
<b>Ubuntu 20.04 LTS:</b>
55+
```bash
56+
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u20
5757
```
5858

59-
<b>Ubuntu 16.04 LTS:</b>
59+
<b>Ubuntu 18.04 LTS:</b>
6060
```powershell
61-
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u16
61+
docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18
6262
```
6363

6464
>[!TIP]

articles/service-fabric/service-fabric-quickstart-containers-linux.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ az group create --name $ResourceGroupName --location $Location
7575
# Create secure five node Linux cluster. Creates a key vault in a resource group
7676
# and creates a certificate in the key vault. The certificate's subject name must match
7777
# the domain that you use to access the Service Fabric cluster. The certificate is downloaded locally.
78-
az sf cluster create --resource-group $ResourceGroupName --location $Location --certificate-output-folder . --certificate-password $Password --certificate-subject-name $Subject --cluster-name $ClusterName --cluster-size 5 --os UbuntuServer1604 --vault-name $VaultName --vault-resource-group $ResourceGroupName --vm-password $VmPassword --vm-user-name $VmUserName
78+
az sf cluster create --resource-group $ResourceGroupName --location $Location --certificate-output-folder . --certificate-password $Password --certificate-subject-name $Subject --cluster-name $ClusterName --cluster-size 5 --os UbuntuServer1804 --vault-name $VaultName --vault-resource-group $ResourceGroupName --vm-password $VmPassword --vm-user-name $VmUserName
7979
```
8080

8181
> [!Note]
@@ -87,12 +87,12 @@ az sf cluster create --resource-group $ResourceGroupName --location $Location --
8787
Service Fabric provides several tools that you can use to manage a cluster and its applications:
8888

8989
- Service Fabric Explorer, a browser-based tool.
90-
- Service Fabric Command Line Interface (CLI), which runs on top of Azure CLI.
90+
- Service Fabric Command Line Interface (CLI), which runs on top of Azure CLI.
9191
- PowerShell commands.
9292

9393
In this quickstart, you use the Service Fabric CLI and Service Fabric Explorer (a web based tool). To use Service Fabric Explorer, you need to import the certificate PFX file into the browser. By default, the PFX file has no password.
9494

95-
Mozilla Firefox is the default browser in Ubuntu 16.04. To import the certificate into Firefox, click the menu button in the upper right corner of your browser, then click **Options**. On the **Preferences** page, use the search box to search for "certificates". Click **View Certificates**, select the **Your Certificates** tab, click **Import** and follow the prompts to import the certificate.
95+
Mozilla Firefox is the default browser in Ubuntu 18.04. To import the certificate into Firefox, click the menu button in the upper right corner of your browser, then click **Options**. On the **Preferences** page, use the search box to search for "certificates". Click **View Certificates**, select the **Your Certificates** tab, click **Import** and follow the prompts to import the certificate.
9696

9797
![Install certificate on Firefox](./media/service-fabric-quickstart-containers-linux/install-cert-firefox.png)
9898

0 commit comments

Comments
 (0)