Merge pull request #12 from keirthana/add-discourse-docs-PRs-320-321-322

Add discourse docs PRs 320, 321, 322

.wordlist.txt

@@ -279,6 +279,7 @@ UTF
 validator
 vCPU
 vCPUs
+VHAL
 viewport
 VirGL
 virglrenderer

howto/instance/logs.md

@@ -5,13 +5,13 @@ You can view the Anbox and the Android system logs while an instance is running,
 
 While an instance is running, you can use the `amc` command to access both the Anbox and the Android system logs. The following command shows the system log:
 
-    amc logs -t <log type>
+    amc logs -t <log type> <instance_id>
 
 As `<log type>`, specify either `anbox` for the Anbox system log or `android` for the Android one. If you don't specify the log type, the Anbox system log is displayed by default.
 
 To follow the log and get automatic updates for new entries, add the `-f` argument:
 
-    amc logs -t anbox -f
+    amc logs -t anbox -f <instance_id>
 
 This will show the logs and update the output whenever new entries are added.
 

ref/component-versions.md

@@ -2,6 +2,76 @@ This documents the versions of the different components for each Anbox Cloud rel
 
 Not all components are updated with each release. When components are not updated, this is called out in the [release notes](https://discourse.ubuntu.com/t/release-notes/17842) and components are marked with `n/a` below.
 
+[Details=1.20.1]
+### Charms
+
+#### Ubuntu 22.04
+
+| Name | Channel | Revision |
+|----------|--------------|--------------|
+| `anbox-cloud-dashboard` | `1.20/stable` | 259 |
+| `ams-node-controller` | `1.20/stable` | 267 |
+| `coturn` | `1.20/stable` | 261 |
+| `ams` | `1.20/stable` | 272 |
+| `aar` | `1.20/stable` | 266 |
+| `anbox-stream-gateway` | `1.20/stable` | 277 |
+| `ams-load-balancer` | `1.20/stable` | 267 |
+| `ams-lxd` | `1.20/stable` | 264 |
+| `anbox-stream-agent` | `1.20/stable` | 272 |
+| `nats ` | `latest/stable` | 11 |
+
+#### Ubuntu 20.04
+
+| Name | Channel | Revision |
+|----------|--------------|--------------|
+| `anbox-cloud-dashboard` | `1.20/stable` | 258 |
+| `ams-node-controller` | `1.20/stable` | 266 |
+| `coturn` | `1.20/stable` | 260 |
+| `ams` | `1.20/stable` | 271 |
+| `aar` | `1.20/stable` | 265 |
+| `anbox-stream-gateway` | `1.20/stable` | 276 |
+| `ams-load-balancer` | `1.20/stable` | 266 |
+| `ams-lxd` | `1.20/stable` | 263 |
+| `anbox-stream-agent` | `1.20/stable` | 271 |
+| `nats ` | `latest/stable` | 11 |
+
+### Validated revisions of 3rd party charms
+
+n/a
+
+### Bundles
+
+| Name | Channel | Revision |
+|----------|--------------|--------------|
+| `anbox-cloud` | `1.20/stable` | 159 |
+| `anbox-cloud-core` | `1.20/stable` | 164 |
+
+### Snaps
+
+| Name |  Channel | Version |
+|----------|--------------|---------|
+| `ams`    | `1.20/stable` | 1.20.1 |
+| `aar`    | `1.20/stable` | 1.20.1 |
+| `ams-node-controller` | `1.20/stable` | 1.20.1 |
+| `anbox-cloud-dashboard` | `1.20/stable` | 1.20.1 |
+| `anbox-stream-agent` | `1.20/stable` | 1.20.1 |
+| `anbox-stream-gateway` | `1.20/stable` | 1.20.1 |
+| `anbox-cloud-appliance` | `1.20/stable` | 1.20.1 |
+
+
+### Anbox images
+
+| Name | Version |
+|----------|--------------|
+| `jammy:android13:amd64` | 1.20.1 |
+| `jammy:android13:arm64` | 1.20.1 |
+| `jammy:android12:amd64` | 1.20.1 |
+| `jammy:android12:arm64` | 1.20.1 |
+| `jammy:android11:amd64` | 1.20.1 |
+| `jammy:android11:arm64` | 1.20.1 |
+
+[/Details]
+
 [Details=1.20.0]
 ### Charms
 

ref/release-notes.md

@@ -7,13 +7,15 @@ The following dates for upcoming releases are not final and could vary depending
 
 | Tentative Release date | Planned release version |
 |----|----|
-|December 13 2023|Anbox Cloud 1.20.1|
-|January 17 2024|Anbox Cloud 1.20.2|
+
+| January 17 2024 | Anbox Cloud 1.20.2 |
+| February 14 2024 | Anbox Cloud 1.21.0 |
 
 ## Recent releases
 
 | Release date   |  Release notes  |
 |----|----|
+|December 13 2023|[Anbox Cloud 1.20.1](https://discourse.ubuntu.com/t/40988)|
 | November 16 2023 | [Anbox Cloud 1.20.0](https://discourse.ubuntu.com/t/40281) |
 
 ### What's new in 1.20.x?

ref/roadmap.md

@@ -11,5 +11,5 @@ Anbox Cloud follows a defined release cycle with frequent minor and patch releas
 ## Roadmap
 | Release | Target Date | What to expect| 
 |---------|-------------|---------------|
-| 1.20.1 | December 13 2023 | * Android security updates for December 2023<br/>* Bug fixes |
 | 1.20.2 | January 17 2024  | * Android security updates for January 2023<br/>* Bug fixes |
+| 1.21.0 | February 14, 2024 | * Production support for Vulkan on NVIDIA GPUs<br/>* Add automotive-enabled Anbox Cloud images<br/>* Support for IAM role based authentication in AAR<br/>* TLS support for `anbox-cloud-nfs-operator` charm.<br/>* Android security updates for February 2023<br/>* Bug fixes |

release-notes/1.20.1.md

@@ -0,0 +1,41 @@
+## Introduction
+
+The Anbox Cloud team is pleased to announce the release of Anbox Cloud 1.20.1.
+
+Please see [component versions](https://anbox-cloud.io/docs/ref/component-versions) for a list of updated components.
+
+## New features & improvements
+
+* A new `amc image sync` command is available to explicitly trigger download of an image from the image server. <!--AC-2085-->
+* The Anbox Management Service (AMS) derives instance architecture from the architecture of the selected image instead of the Application Binary Interface (ABI).<!--AC-2138-->
+* Android security updates for December 2023 (see [Android Security Bulletin - December 2023](https://source.android.com/docs/security/bulletin/2023-12-01) for more information).<!--AC-2127-->
+* The Android WebView has been updated to [120.0.6099.43](https://chromereleases.googleblog.com/2023/11/early-stable-update-for-android.html).
+* `amc` returns better error details when the AMS client is not registered to the LXD cluster. <!--AC-2097-->
+* When an instance is being created, better status messages that give information on the steps of instance creation are displayed. These status messages are cleared once the instance moves to running status. <!--AC-2120-->
+* In the AMS HTTP API, the `ErrorMessage` field is moved from the `types.Image` to the `types.ImageVersion` object. <!--AC-2047-->
+
+## Bugs fixed
+* Post an Anbox Cloud appliance upgrade, streaming fails because the stream agent and gateway could not communicate with each other. <!--AC-2139-->
+* Instances are not able to start the nested Android LXD container.<!--AC-2136-->
+* Base instances are available for deletion on the *Instances* list page of the web dashboard. <!--AC-2146-->
+* The web dashboard allows to edit immutable applications, for example, an application synchronised from the application registry. <!--AC-2144-->
+* LXD charm fails in `api-relation-changed` hook. <!--AC-2070-->
+* A session that has an error status is stuck with a connecting indicator instead of displaying the error details. <!--AC-2141-->
+
+## Known issues
+
+Since 1.20.0, Android 11 instances fail to start with pure software rendering (i.e., without any GPU attached) because of a missing library. This will be fixed in 1.20.2.
+
+Affected users can solve the issue by installing the missing package in a pre-start [hook](https://anbox-cloud.io/docs/ref/hooks):
+```
+#!/bin/sh -ex
+if  [ "$CONTAINER_TYPE" = "regular" ]; then
+  exit 0
+fi
+apt update
+apt install --no-install-recommends -y libgl1-mesa-dri
+```
+
+## Upgrade instructions
+
+See [Upgrade Anbox Cloud](https://anbox-cloud.io/docs/howto/update/upgrade-anbox) or [Upgrade the Anbox Cloud Appliance](https://anbox-cloud.io/docs/howto/update/upgrade-appliance) for instructions on how to update your Anbox Cloud deployment to the 1.20.1 release.