Session manager update

strohm-a · strohm-a · commit 5ed62cb2833c · 2020-07-21T08:51:59.000-07:00
diff --git a/doc_source/build-env-ref-available.md b/doc_source/build-env-ref-available.md
@@ -12,8 +12,9 @@ AWS CodeBuild manages the following Docker images that are available in the Code
 | Ubuntu 18\.04 | aws/codebuild/standard:3\.0 | [ubuntu/standard/3\.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/ubuntu/standard/3.0) | 
 | Ubuntu 18\.04 | aws/codebuild/standard:2\.0 ¹ | [ubuntu/standard/2\.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/ubuntu/standard/2.0) | 
 | Windows Server Core 2016 | aws/codebuild/windows\-base:2\.0 | N/A | 
+| Windows Server Core 2019 | aws/codebuild/windows\-base:2019\-1\.0 | N/A | 
 
-¹ No longer maintained after June, 2020\.
+¹ No longer maintained after June 2020\.
 
  The latest version of each image is cached\. If you specify a more specific version, then CodeBuild provisions that version instead of the cached version\. This can result in longer build times\. For example, to benefit from caching, specify `aws/codebuild/amazonlinux2-x86_64-standard:3.0` instead of a more granular version, such as `aws/codebuild/amazonlinux2-x86_64-standard:3.0-1.0.0`\. 
 
@@ -28,7 +29,7 @@ AWS CodeBuild manages the following Docker images that are available in the Code
 **Note**  
 The `aws/codebuild/amazonlinux2-aarch64-standard:1.0` image does not support the Android Runtime \(ART\)\.
 
- The base image of the Windows Server Core 2016 contains the following runtimes\. 
+The base image of the Windows Server Core 2016 contains the following runtimes\.
 
 
 | Runtime name | Version in `windows-base:2.0` | 
@@ -41,8 +42,22 @@ The `aws/codebuild/amazonlinux2-aarch64-standard:1.0` image does not support the
 | python | 3\.7 | 
 | ruby | 2\.6 | 
 
+The base image of the Windows Server Core 2019 contains the following runtimes\.
+
+
+| Runtime name | Version in `windows-base:2019-1.0` | 
+| --- | --- | 
+| dotnet | 3\.1\.3 | 
+| golang | 1\.14 | 
+| nodejs | 12\.18 | 
+| java | corretto11 | 
+| php | 7\.3, 7\.4 | 
+| powershell | 7\.0\.2 | 
+| python | 3\.7, 3\.8 | 
+| ruby | 2\.7 | 
+
 **Note**  
- The base image of the Windows Server Core 2016 platform is available in the US East \(N\. Virginia\), US East \(Ohio\), US West \(Oregon\), and Europe \(Ireland\) regions only\. 
+ The base image of the Windows Server Core 2016 and Windows Server Core 2016 platforms are available in the US East \(N\. Virginia\), US East \(Ohio\), US West \(Oregon\), and Europe \(Ireland\) Regions only\. 
 
 You can use a build specification to install other components \(for example, the AWS CLI, Apache Maven, Apache Ant, Mocha, RSpec, or similar\) during the `install` build phase\. For more information, see [Buildspec example](build-spec-ref.md#build-spec-ref-example)\.
 
diff --git a/doc_source/build-env-ref-cmd.md b/doc_source/build-env-ref-cmd.md
@@ -13,4 +13,4 @@ You can specify any Shell Command Language \(sh\) command\. In buildspec version
 
 If CodeBuild encounters an error, the error might be more difficult to troubleshoot compared to running a single command in its own instance of the default shell\.
 
-Commands that are run in a Windows Server Core 2016 image use the Powershell shell\.
+Commands that are run in a Windows Server Core 2016 image use the PowerShell shell\.
diff --git a/doc_source/build-env-ref-compute-types.md b/doc_source/build-env-ref-compute-types.md
@@ -18,18 +18,18 @@ The disk space listed for each build environment is available only in the direct
 
 **Note**  
  Some environment and compute types have limitations:   
-The environment type `LINUX_GPU_CONTAINER` is available only in regions US East \(N\. Virginia\), US West \(Oregon\), Canada \(Central\), Europe \(Ireland\), Europe \(London\), Europe \(Frankfurt\), Asia Pacific \(Tokyo\), Asia Pacific \(Seoul\), Asia Pacific \(Singapore\), Asia Pacific \(Sydney\) , China \(Beijing\), and China \(Ningxia\)\.
-The environment type `ARM_CONTAINER` is available only in regions US East \(N\. Virginia\), US East \(Ohio\), US West \(Oregon\), Europe \(Ireland\), Asia Pacific \(Mumbai\), Asia Pacific \(Tokyo\), Asia Pacific \(Sydney\), and Europe \(Frankfurt\)\.
-The compute type `build.general1.2xlarge` is available only in regions US East \(N\. Virginia\), US East \(Ohio\), US West \(N\. California\), US West \(Oregon\), Canada \(Central\), South America \(São Paulo\), Europe \(Stockholm\), Europe \(Ireland\), Europe \(London\), Europe \(Paris\), Europe \(Frankfurt\), Middle East \(Bahrain\), Asia Pacific \(Hong Kong\), Asia Pacific \(Tokyo\), Asia Pacific \(Seoul\), Asia Pacific \(Singapore\), Asia Pacific \(Sydney\), Asia Pacific \(Mumbai\), China \(Beijing\), and China \(Ningxia\)\.
+The environment type `LINUX_GPU_CONTAINER` is available only in Regions US East \(N\. Virginia\), US West \(Oregon\), Canada \(Central\), Europe \(Ireland\), Europe \(London\), Europe \(Frankfurt\), Asia Pacific \(Tokyo\), Asia Pacific \(Seoul\), Asia Pacific \(Singapore\), Asia Pacific \(Sydney\), China \(Beijing\), and China \(Ningxia\)\.
+The environment type `ARM_CONTAINER` is available only in Regions US East \(N\. Virginia\), US East \(Ohio\), US West \(Oregon\), Europe \(Ireland\), Asia Pacific \(Mumbai\), Asia Pacific \(Tokyo\), Asia Pacific \(Sydney\), and Europe \(Frankfurt\)\.
+The compute type `build.general1.2xlarge` is available only in Regions US East \(N\. Virginia\), US East \(Ohio\), US West \(N\. California\), US West \(Oregon\), Canada \(Central\), South America \(São Paulo\), Europe \(Stockholm\), Europe \(Ireland\), Europe \(London\), Europe \(Paris\), Europe \(Frankfurt\), Middle East \(Bahrain\), Asia Pacific \(Hong Kong\), Asia Pacific \(Tokyo\), Asia Pacific \(Seoul\), Asia Pacific \(Singapore\), Asia Pacific \(Sydney\), Asia Pacific \(Mumbai\), China \(Beijing\), and China \(Ningxia\)\.
 For the compute type `build.general1.2xlarge`, Docker images up to 100 GB uncompressed are supported\.
 
 
 **Operating system: Windows**  
 
 | Compute type | computeType value | Memory | vCPUs | Disk space | Environment type | 
 | --- | --- | --- | --- | --- | --- | 
-| build\.general1\.medium | BUILD\_GENERAL1\_MEDIUM | 7 GB | 4 | 128 GB | WINDOWS\_CONTAINER | 
-| build\.general1\.large | BUILD\_GENERAL1\_LARGE | 15 GB | 8 | 128 GB | WINDOWS\_CONTAINER | 
+| build\.general1\.medium | BUILD\_GENERAL1\_MEDIUM | 7 GB | 4 | 128 GB |  WINDOWS\_CONTAINER WINDOWS\_SERVER\_2019\_CONTAINER  | 
+| build\.general1\.large | BUILD\_GENERAL1\_LARGE | 15 GB | 8 | 128 GB |  WINDOWS\_CONTAINER WINDOWS\_SERVER\_2019\_CONTAINER  | 
 
 **Note**  
 For custom build environment images, CodeBuild supports Docker images up to 50 GB uncompressed in Linux and Windows, regardless of the compute type\. To check your build image's size, use Docker to run the `docker images REPOSITORY:TAG` command\.
diff --git a/doc_source/builds-working.md b/doc_source/builds-working.md
@@ -19,4 +19,5 @@ You can perform these tasks when working with builds:
 + [View a list of build IDs in AWS CodeBuild](view-build-list.md)
 + [View a list of build IDs for a build project in AWS CodeBuild](view-builds-for-project.md)
 + [Stop a build in AWS CodeBuild](stop-build.md)
++ [View a running build in Session Manager](session-manager.md)
 + [Delete builds in AWS CodeBuild](delete-builds.md)
diff --git a/doc_source/create-project-cli.md b/doc_source/create-project-cli.md
@@ -298,6 +298,7 @@ Docker layer cache mode is available for Linux only\. If you choose it, your pro
        + `LINUX_CONTAINER`
        + `LINUX_GPU_CONTAINER`
        + `WINDOWS_CONTAINER`
+       + `WINDOWS_SERVER_2019_CONTAINER`
      + *image*: Required\. The Docker image identifier used by this build environment\. Typically, this identifier is expressed as *image\-name*:*tag*\. For example, in the Docker repository that CodeBuild uses to manage its Docker images, this could be `aws/codebuild/standard:4.0`\. In Docker Hub, `maven:3.3.9-jdk-8`\. In Amazon ECR, `account-id.dkr.ecr.region-id.amazonaws.com/your-Amazon-ECR-repo-name:tag`\. For more information, see [Docker images provided by CodeBuild](build-env-ref-available.md)\. 
      + *computeType*: Required\. A category that corresponds to the number of CPU cores and memory used by this build environment\. Allowed values include:
        + `BUILD_GENERAL1_SMALL`
diff --git a/doc_source/history.md b/doc_source/history.md
@@ -2,11 +2,13 @@
 
 The following table describes the important changes to the documentation since the last release of AWS CodeBuild\. For notification about updates to this documentation, you can subscribe to an RSS feed\.
 + **Latest API version:** 2016\-10\-06
-+ **Latest documentation update: **May 29, 2020
++ **Latest documentation update: **July 20, 2020
 
 | Change | Description | Date | 
 | --- |--- |--- |
-| [Updated topic](#history) |  CodeBuild now supports specifying a shell to use in their build environments in the buildspec file\. For more information, see [Build specification reference](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html)\. | June 25, 2020 | 
+| [Windows Server 2019 image](#history) | CodeBuild now provides a Windows Server Core 2019 build image\. For more information, see [Docker images provided by CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-available.html)\.  | July 20, 2020 | 
+| [Session Manager](#history) | CodeBuild now allows you to pause a running build and then use AWS Systems Manager Session Manager to connect to the build container and view the state of the container\. For more information, see [Session Manager](https://docs.aws.amazon.com/codebuild/latest/userguide/session-manager.html)\. | July 20, 2020 | 
+| [Updated topic](#history) |  CodeBuild now supports specifying a shell to use in their build environments in the buildspec file\. For more information, see [Build specification reference](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html)\.  | June 25, 2020 | 
 | [Test reporting with test frameworks](#history) | Added several topics the describe how to generate CodeBuild test reports with several test frameworks\. For more information, see [Test reporting with test frameworks](https://docs.aws.amazon.com/codebuild/latest/userguide/test-framework-reporting.html)\. | May 29, 2020 | 
 | [Updated topics](#history) | CodeBuild now supports adding tags to report groups\. For more information, see [ReportGroup](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ReportGroup.html)\. | May 21, 2020 | 
 | [Support for test reporting](#history) | CodeBuild support for test reporting is now generally available\. | May 21, 2020 | 
diff --git a/doc_source/index.md b/doc_source/index.md
@@ -110,6 +110,7 @@ Amazon's trademarks and trade dress may not be used in
       + [View a list of build IDs in AWS CodeBuild](view-build-list.md)
       + [View a list of build IDs for a build project in AWS CodeBuild](view-builds-for-project.md)
       + [Stop a build in AWS CodeBuild](stop-build.md)
+      + [View a running build in Session Manager](session-manager.md)
       + [Delete builds in AWS CodeBuild](delete-builds.md)
 + [Working with test reporting in AWS CodeBuild](test-reporting.md)
    + [Create a test report](report-create.md)
diff --git a/doc_source/run-build.md b/doc_source/run-build.md
@@ -229,9 +229,9 @@ If your source code is stored in a GitHub or a GitHub Enterprise Server reposito
 Run the create\-webhookcommand as follows:
 
 ```
-aws codebuild create-webhook --project-name 
+aws codebuild create-webhook --project-name <project-name>
 ```
-+ where *project\-name* is the name of the build project that contains the source code to be rebuilt\.
++ where *<project\-name>* is the name of the build project that contains the source code to be rebuilt\.
 
 For GitHub, information similar to the following appears in the output:
 
@@ -261,9 +261,9 @@ If your source code is stored in a GitHub or a GitHub Enterprise Server reposito
 If you have enabled this behavior, you can turn it off by running the `delete-webhook` command as follows:
 
 ```
-aws codebuild delete-webhook --project-name  
+aws codebuild delete-webhook --project-name <project-name>
 ```
-+ where *project\-name* is the name of the build project that contains the source code to be rebuilt\.
++ where *<project\-name>* is the name of the build project that contains the source code to be rebuilt\.
 
 If this command is successful, no information and no errors appear in the output\.
 
diff --git a/doc_source/sample-windows.md b/doc_source/sample-windows.md
@@ -1,6 +1,6 @@
 # Microsoft Windows samples for CodeBuild<a name="sample-windows"></a>
 
-These samples use an AWS CodeBuild build environment running Microsoft Windows Server 2016, the \.NET Framework, and the \.NET Core SDK to build executables file out of code written in C\#, F\#, and Visual Basic\. 
+These samples use an AWS CodeBuild build environment running Microsoft Windows Server 2019, the \.NET Framework, and the \.NET Core SDK to build executables file out of code written in C\#, F\#, and Visual Basic\. 
 
 **Important**  
 Running these samples might result in charges to your AWS account\. These include possible charges for CodeBuild and for AWS resources and actions related to Amazon S3, AWS KMS, and CloudWatch Logs\. For more information, see [CodeBuild pricing](http://aws.amazon.com/codebuild/pricing), [Amazon S3 pricing](http://aws.amazon.com/s3/pricing), [AWS Key Management Service pricing](http://aws.amazon.com/kms/pricing), and [Amazon CloudWatch pricing](http://aws.amazon.com/cloudwatch/pricing)\.
@@ -32,8 +32,8 @@ If you are using an S3 input bucket, be sure to create a ZIP file that contains
        "name": "windows-build-output-artifact.zip"
      },
      "environment": {
-       "type": "WINDOWS_CONTAINER",
-       "image": "aws/codebuild/windows-base:1.0",
+       "type": "WINDOWS_SERVER_2019_CONTAINER",
+       "image": "aws/codebuild/windows-base:2019-1.0",
        "computeType": "BUILD_GENERAL1_MEDIUM"
      },
      "serviceRole": "arn:aws:iam::account-ID:role/role-name",
@@ -122,7 +122,7 @@ env:
   variables:
     SOLUTION: .\CSharpHelloWorld.sln
     PACKAGE_DIRECTORY: .\packages
-    DOTNET_FRAMEWORK: 4.6.2
+    DOTNET_FRAMEWORK: 4.8
 
 phases:
   build:
@@ -166,7 +166,7 @@ EndGlobal
 <?xml version="1.0" encoding="utf-8" ?>
 <configuration>
   <startup> 
-    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.2" />
+    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
   </startup>
 </configuration>
 ```
@@ -185,7 +185,7 @@ EndGlobal
     <AppDesignerFolder>Properties</AppDesignerFolder>
     <RootNamespace>CSharpHelloWorld</RootNamespace>
     <AssemblyName>CSharpHelloWorld</AssemblyName>
-    <TargetFrameworkVersion>v4.6.2</TargetFrameworkVersion>
+    <TargetFrameworkVersion>v4.8</TargetFrameworkVersion>
     <FileAlignment>512</FileAlignment>
     <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
   </PropertyGroup>
@@ -310,7 +310,7 @@ env:
   variables:
     SOLUTION: .\FSharpHelloWorld.sln
     PACKAGE_DIRECTORY: .\packages
-    DOTNET_FRAMEWORK: 4.6.2
+    DOTNET_FRAMEWORK: 4.8
 
 phases:
   build:
@@ -354,7 +354,7 @@ EndGlobal
 <?xml version="1.0" encoding="utf-8" ?>
 <configuration>
   <startup> 
-    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.2" />
+    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
   </startup>
 </configuration>
 ```
@@ -419,7 +419,7 @@ do
     <OutputType>Exe</OutputType>
     <RootNamespace>FSharpHelloWorld</RootNamespace>
     <AssemblyName>FSharpHelloWorld</AssemblyName>
-    <TargetFrameworkVersion>v4.6.2</TargetFrameworkVersion>
+    <TargetFrameworkVersion>v4.8</TargetFrameworkVersion>
     <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
     <TargetFSharpCoreVersion>4.4.0.0</TargetFSharpCoreVersion>
     <Name>FSharpHelloWorld</Name>
@@ -510,7 +510,7 @@ env:
   variables:
     SOLUTION: .\VBHelloWorld.sln
     PACKAGE_DIRECTORY: .\packages
-    DOTNET_FRAMEWORK: 4.6.2
+    DOTNET_FRAMEWORK: 4.8
 
 phases:
   build:
@@ -554,7 +554,7 @@ EndGlobal
 <?xml version="1.0" encoding="utf-8" ?>
 <configuration>
   <startup> 
-    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.2" />
+    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
   </startup>
 </configuration>
 ```
@@ -587,7 +587,7 @@ End Module
     <AssemblyName>VBHelloWorld</AssemblyName>
     <FileAlignment>512</FileAlignment>
     <MyType>Console</MyType>
-    <TargetFrameworkVersion>v4.6.2</TargetFrameworkVersion>
+    <TargetFrameworkVersion>v4.8</TargetFrameworkVersion>
     <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
   </PropertyGroup>
   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
diff --git a/doc_source/session-manager.md b/doc_source/session-manager.md

Original file line number	Diff line number	Diff line change
`@@ -13,4 +13,4 @@ You can specify any Shell Command Language \(sh\) command\. In buildspec version`
`13`	`13`
`14`	`14`	`If CodeBuild encounters an error, the error might be more difficult to troubleshoot compared to running a single command in its own instance of the default shell\.`
`15`	`15`
`16`		`-Commands that are run in a Windows Server Core 2016 image use the Powershell shell\.`
	`16`	`+Commands that are run in a Windows Server Core 2016 image use the PowerShell shell\.`