From 5ba6ca8d44ba024acc6b511c88389ded1c2d7f43 Mon Sep 17 00:00:00 2001 From: Keirthana T S Date: Wed, 9 Oct 2024 21:42:37 +0530 Subject: [PATCH 01/16] Create 1.23.2 release notes --- reference/component-versions.md | 328 +++-------------------- reference/release-notes/1.23.2.md | 71 +++++ reference/release-notes/release-notes.md | 14 +- 3 files changed, 120 insertions(+), 293 deletions(-) create mode 100644 reference/release-notes/1.23.2.md diff --git a/reference/component-versions.md b/reference/component-versions.md index b78f14c2..b2552e11 100644 --- a/reference/component-versions.md +++ b/reference/component-versions.md @@ -5,6 +5,48 @@ 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, they are marked with `n/a` below. +## 1.23.2 + +### Charms + +#### Ubuntu 22.04 + +| Name | Channel | Revision | +|----------|--------------|--------------| +| | | | + + +#### Ubuntu 20.04 (Deprecated) + +| Name | Channel | Revision | +|----------|--------------|--------------| +| | | | + +### Bundles + +| Name | Channel | Revision | +|----------|--------------|--------------| +| | | | + +### Snaps + +| Name | Channel | Version | +|----------|--------------|---------| +| | | | + +### Anbox images + +The following Anbox images are available in two variants: one based on a container and one based on a virtual machine. + +| Name | Version | +|----------|--------------| +| `jammy:android13:amd64` | | +| `jammy:android13:arm64` | | +| `jammy:android12:amd64` | | +| `jammy:android12:arm64` | | +| `jammy:aaos13:amd64` | | +| `jammy:aaos13:arm64` | | + ## 1.23.1 ### Charms @@ -133,289 +175,3 @@ The following Anbox images are available in two variants: one based on a contain | `jammy:android12:arm64` | `1.23.0-20240809080136.4a6ba963a` | | `jammy:aaos13:amd64` | `1.23.0-20240809080136.4a6ba963a` | | `jammy:aaos13:arm64` | `1.23.0-20240809080136.4a6ba963a` | - -## 1.22.2 - -### Charms - -N/A - -### Bundles - -N/A - -### Snaps - -| Name | Channel | Version | -|----------|--------------|---------| -| `ams` | `1.22/stable` | 1.22.2 | -| `aar` | `1.22/stable` | 1.22.2 | -| `ams-node-controller` | `1.22/stable` | 1.22.2 | -| `anbox-cloud-dashboard` | `1.22/stable` | 1.22.2 | -| `anbox-stream-agent` | `1.22/stable` | 1.22.2 | -| `anbox-stream-gateway` | `1.22/stable` | 1.22.2 | -| `anbox-cloud-appliance` | `1.22/stable` | 1.22.2 | - - -### Anbox images - -| Name | Version | -|----------|--------------| -| `jammy:android13:amd64` | 1.22.2 | -| `jammy:android13:arm64` | 1.22.2 | -| `jammy:android12:amd64` | 1.22.2 | -| `jammy:android12:arm64` | 1.22.2 | -| `jammy:aaos13:amd64` (Experimental) | 1.22.2 | -| `jammy:aaos13:arm64` (Experimental) | 1.22.2 | - -## 1.22.1 - -### Charms - -N/A - -### Bundles - -N/A - -### Snaps - -| Name | Channel | Version | -|----------|--------------|---------| -| `ams` | `1.22/stable` | 1.22.1 | -| `aar` | `1.22/stable` | 1.22.1 | -| `ams-node-controller` | `1.22/stable` | 1.22.1 | -| `anbox-cloud-dashboard` | `1.22/stable` | 1.22.1 | -| `anbox-stream-agent` | `1.22/stable` | 1.22.1 | -| `anbox-stream-gateway` | `1.22/stable` | 1.22.1 | -| `anbox-cloud-appliance` | `1.22/stable` | 1.22.1 | - - -### Anbox images - -| Name | Version | -|----------|--------------| -| `jammy:android13:amd64` | 1.22.1 | -| `jammy:android13:arm64` | 1.22.1 | -| `jammy:android12:amd64` | 1.22.1 | -| `jammy:android12:arm64` | 1.22.1 | -| `jammy:aaos13:amd64` (Experimental) | 1.22.1 | -| `jammy:aaos13:arm64` (Experimental) | 1.22.1 | - -## 1.22.0 - -### Charms - -#### Ubuntu 22.04 - -| Name | Channel | Revision | -|----------|--------------|--------------| -| `anbox-cloud-dashboard` | `1.22/stable` | 417 | -| `ams-node-controller` | `1.22/stable` | 425 | -| `coturn` | `1.22/stable` | 419 | -| `ams` | `1.22/stable` | 449 | -| `aar` | `1.22/stable` | 426 | -| `anbox-stream-gateway` | `1.22/stable` | 435 | -| `ams-lxd` | `1.22/stable` | 422 | -| `anbox-stream-agent` | `1.22/stable` | 430 | -| `nats ` | `latest/stable` | 11 | - -#### Ubuntu 20.04 (Deprecated) - -| Name | Channel | Revision | -|----------|--------------|--------------| -| `anbox-cloud-dashboard` | `1.22/stable` | 416 | -| `ams-node-controller` | `1.22/stable` | 424 | -| `coturn` | `1.22/stable` | 418 | -| `ams` | `1.22/stable` | 448 | -| `aar` | `1.22/stable` | 425 | -| `anbox-stream-gateway` | `1.22/stable` | 434 | -| `ams-lxd` | `1.22/stable` | 421 | -| `anbox-stream-agent` | `1.22/stable` | 429 | -| `nats ` | `latest/stable` | 11 | - -### Bundles - -| Name | Channel | Revision | -|----------|--------------|--------------| -| `anbox-cloud` | `1.22/stable` | 234 | -| `anbox-cloud-core` | `1.22/stable` | 242 | - -### Snaps - -| Name | Channel | Version | -|----------|--------------|---------| -| `ams` | `1.22/stable` | 1.22.0 | -| `aar` | `1.22/stable` | 1.22.0 | -| `ams-node-controller` | `1.22/stable` | 1.22.0 | -| `anbox-cloud-dashboard` | `1.22/stable` | 1.22.0 | -| `anbox-stream-agent` | `1.22/stable` | 1.22.0 | -| `anbox-stream-gateway` | `1.22/stable` | 1.22.0 | -| `anbox-cloud-appliance` | `1.22/stable` | 1.22.0 | - - -### Anbox images - -| Name | Version | -|----------|--------------| -| `jammy:android13:amd64` | 1.22.0 | -| `jammy:android13:arm64` | 1.22.0 | -| `jammy:android12:amd64` | 1.22.0 | -| `jammy:android12:arm64` | 1.22.0 | -| `jammy:aaos13:amd64` (Experimental) | 1.22.0 | -| `jammy:aaos13:arm64` (Experimental) | 1.22.0 | - - -## 1.21.2 - -### Charms - -N/A - -### Bundles - -N/A - -### Snaps - -| Name | Channel | Version | -|----------|--------------|---------| -| `anbox-cloud-appliance` | `1.21/stable` | 1.21.2 | - - -### Anbox images - -| Name | Version | -|----------|--------------| -| `jammy:android13:amd64` | 1.21.2 | -| `jammy:android13:arm64` | 1.21.2 | -| `jammy:android12:amd64` | 1.21.2 | -| `jammy:android12:arm64` | 1.21.2 | -| `jammy:aaos13:amd64` (Experimental) | 1.21.2 | -| `jammy:aaos13:arm64` (Experimental) | 1.21.2 | - -## 1.21.1 - -### Charms - -#### Ubuntu 22.04 - -| Name | Channel | Revision | -|----------|--------------|--------------| -| `anbox-cloud-dashboard` | `1.21/stable` | 307 | -| `ams-node-controller` | `1.21/stable` | 315 | -| `coturn` | `1.21/stable` | 309 | -| `ams` | `1.21/stable` | 320 | -| `aar` | `1.21/stable` | 314 | -| `anbox-stream-gateway` | `1.21/stable` | 325 | -| `ams-lxd` | `1.21/stable` | 312 | -| `anbox-stream-agent` | `1.21/stable` | 320 | -| `nats ` | `latest/stable` | 11 | - -#### Ubuntu 20.04 - -| Name | Channel | Revision | -|----------|--------------|--------------| -| `anbox-cloud-dashboard` | `1.21/stable` | 306 | -| `ams-node-controller` | `1.21/stable` | 314 | -| `coturn` | `1.21/stable` | 308 | -| `ams` | `1.21/stable` | 319 | -| `aar` | `1.21/stable` | 313 | -| `anbox-stream-gateway` | `1.21/stable` | 324 | -| `ams-lxd` | `1.21/stable` | 311 | -| `anbox-stream-agent` | `1.21/stable` | 319 | -| `nats ` | `latest/stable` | 11 | - -### Bundles - -| Name | Channel | Revision | -|----------|--------------|--------------| -| `anbox-cloud` | `1.21/stable` | 182 | -| `anbox-cloud-core` | `1.21/stable` | 189 | - -### Snaps - -| Name | Channel | Version | -|----------|--------------|---------| -| `ams` | `1.21/stable` | 1.21.1 | -| `aar` | `1.21/stable` | 1.21.1 | -| `ams-node-controller` | `1.21/stable` | 1.21.1 | -| `anbox-cloud-dashboard` | `1.21/stable` | 1.21.1 | -| `anbox-stream-agent` | `1.21/stable` | 1.21.1 | -| `anbox-stream-gateway` | `1.21/stable` | 1.21.1 | -| `anbox-cloud-appliance` | `1.21/stable` | 1.21.1 | -| `anbox-cloud-tests` | `1.21/stable` | 1.21.1 | - -### Anbox images - -| Name | Version | -|----------|--------------| -| `jammy:android13:amd64` | 1.21.1 | -| `jammy:android13:arm64` | 1.21.1 | -| `jammy:android12:amd64` | 1.21.1 | -| `jammy:android12:arm64` | 1.21.1 | -| `jammy:aaos13:amd64` (Experimental) | 1.21.1 | -| `jammy:aaos13:arm64` (Experimental) | 1.21.1 | - -## 1.21.0 - -### Charms - -#### Ubuntu 22.04 - -| Name | Channel | Revision | -|----------|--------------|--------------| -| `anbox-cloud-dashboard` | `1.21/stable` | 307 | -| `ams-node-controller` | `1.21/stable` | 315 | -| `coturn` | `1.21/stable` | 309 | -| `ams` | `1.21/stable` | 320 | -| `aar` | `1.21/stable` | 314 | -| `anbox-stream-gateway` | `1.21/stable` | 325 | -| `ams-lxd` | `1.21/stable` | 312 | -| `anbox-stream-agent` | `1.21/stable` | 320 | -| `nats ` | `latest/stable` | 11 | - -#### Ubuntu 20.04 - -| Name | Channel | Revision | -|----------|--------------|--------------| -| `anbox-cloud-dashboard` | `1.21/stable` | 306 | -| `ams-node-controller` | `1.21/stable` | 314 | -| `coturn` | `1.21/stable` | 308 | -| `ams` | `1.21/stable` | 319 | -| `aar` | `1.21/stable` | 313 | -| `anbox-stream-gateway` | `1.21/stable` | 324 | -| `ams-lxd` | `1.21/stable` | 311 | -| `anbox-stream-agent` | `1.21/stable` | 319 | -| `nats ` | `latest/stable` | 11 | - -### Bundles - -| Name | Channel | Revision | -|----------|--------------|--------------| -| `anbox-cloud` | `1.21/stable` | 182 | -| `anbox-cloud-core` | `1.21/stable` | 189 | - -### Snaps - -| Name | Channel | Version | -|----------|--------------|---------| -| `ams` | `1.21/stable` | 1.21.0 | -| `aar` | `1.21/stable` | 1.21.0 | -| `ams-node-controller` | `1.21/stable` | 1.21.0 | -| `anbox-cloud-dashboard` | `1.21/stable` | 1.21.0 | -| `anbox-stream-agent` | `1.21/stable` | 1.21.0 | -| `anbox-stream-gateway` | `1.21/stable` | 1.21.0 | -| `anbox-cloud-appliance` | `1.21/stable` | 1.21.0 | - - -### Anbox images - -| Name | Version | -|----------|--------------| -| `jammy:android13:amd64` | 1.21.0 | -| `jammy:android13:arm64` | 1.21.0 | -| `jammy:android12:amd64` | 1.21.0 | -| `jammy:android12:arm64` | 1.21.0 | -| `jammy:aaos13:amd64` (Experimental) | 1.21.0 | -| `jammy:aaos13:arm64` (Experimental) | 1.21.0 | diff --git a/reference/release-notes/1.23.2.md b/reference/release-notes/1.23.2.md new file mode 100644 index 00000000..eb96a1f4 --- /dev/null +++ b/reference/release-notes/1.23.2.md @@ -0,0 +1,71 @@ +--- +orphan: true +--- +# 1.23.2 + +These release notes cover new features and changes in Anbox Cloud 1.23.2. + +Anbox Cloud 1.23.2 is a patch release. To understand minor and patch releases, see {ref}`ref-release-notes`. + +Please see {ref}`ref-component-versions` for a list of updated components. + +## Requirements + +See the {ref}`ref-requirements` for details on general and deployment specific requirements to run Anbox Cloud. + +## New features & improvements + +* Android security updates for October 2024 (see [Android Security Bulletin - October 2024](https://source.android.com/docs/security/bulletin/2024-10-01) for more information). +* The Android WebView has been updated to [129.0.6668.81](https://chromereleases.googleblog.com/2024/10/chrome-for-android-update.html). + +## Known issues + +* Since version 1.23.0, the Anbox WebRTC Data Proxy service starts on demand rather than at container startup. However, its startup time may take longer than expected, which can negatively impact the {ref}`out-of-band data exchange ` between the WebRTC server and client. This issue can be worked around by applying the following tweak in a [pre-start hook](https://anbox-cloud.io/docs/ref/hooks). + + ``` + #!/bin/sh -ex + if [ "$CONTAINER_TYPE" = "regular" ]; then + exit 0 + fi + + DROP_IN_DIR=/etc/systemd/system/anbox-webrtc-data-proxy.service.d/ + sudo mkdir -p "${DROP_IN_DIR}" + sudo tee "${DROP_IN_DIR}/override.conf" > /dev/null < * Bug fixes | | November 14 2024 | Anbox Cloud 1.24.0 | * VHAL improvements
* Android 14 images
* Support for additional upscaling algorithms in the streaming SDK
* Android security updates for November 2024
* Reworked charms
* Bug fixes | | December 11 2024 | Anbox Cloud 1.24.1 | * Android security updates for December 2024
* Bug fixes | | January 15 2025 | Anbox Cloud 1.24.2 | * Android security updates for January 2025
* Bug fixes | @@ -65,10 +62,13 @@ Along with bug fixes and general improvements, Anbox Cloud 1.23.x includes: | Release date | Release notes | |----|----| -| January 17 2024 | [Anbox Cloud 1.20.2](1.20.2.md) | -| February 14 2024 | [Anbox Cloud 1.21.0](1.21.0.md) | -| March 13 2024 | [Anbox Cloud 1.21.1](1.21.1.md) | +| July 18 2024 | [Anbox Cloud 1.22.2](1.22.2.md) | +| June 13 2024 | [Anbox Cloud 1.22.1](1.22.1.md) | +| May 15 2024 | [Anbox Cloud 1.22.0](1.22.0.md) | | April 18 2024 | [Anbox Cloud 1.21.2](1.21.2.md) | +| March 13 2024 | [Anbox Cloud 1.21.1](1.21.1.md) | +| February 14 2024 | [Anbox Cloud 1.21.0](1.21.0.md) | +| January 17 2024 | [Anbox Cloud 1.20.2](1.20.2.md) | |December 13 2023| [Anbox Cloud 1.20.1](1.20.1.md) | |November 16 2023 | [Anbox Cloud 1.20.0](1.20.0.md) | |October 11 2023|[Anbox Cloud 1.19.2](1.19.2.md)| From b639c9ea6c7927fa2763d5dcdc122a7e3653f811 Mon Sep 17 00:00:00 2001 From: Jatin Arora Date: Thu, 10 Oct 2024 14:20:01 +0530 Subject: [PATCH 02/16] feat(conf): update swagger source to refer to local swagger This commit updates the configuration for swagger generate to refer to the api reference swagger present locally in the directory. --- custom_conf.py | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/custom_conf.py b/custom_conf.py index c2d44d8b..ae2df09a 100644 --- a/custom_conf.py +++ b/custom_conf.py @@ -224,13 +224,18 @@ # Inject AMS configuration valuues and Node configuration values from the swagger # specification hosted on Github. def generate_ams_configuration(): - from scripts.ams_configuration import get_swagger_from_url, parse_swagger + from scripts.ams_configuration import parse_swagger with open("scripts/requirements.txt", "r") as f: for req in f.readlines(): custom_required_modules.append(req) ams_configuration_file = "reference/ams-configuration.md" - parse_swagger(get_swagger_from_url(), ams_configuration_file) + import yaml + + with open("reference/api-reference/ams-api.yaml", "r") as f: + swagger = yaml.safe_load(f) + parse_swagger(swagger, ams_configuration_file) + ## The following code is to automatically load the API from swagger into documentation. From c1deeb6db2674206c56342965ebffb5d8e12b99c Mon Sep 17 00:00:00 2001 From: Keirthana T S Date: Thu, 10 Oct 2024 15:29:11 +0530 Subject: [PATCH 03/16] Add CVE source links --- reference/release-notes/1.23.2.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/reference/release-notes/1.23.2.md b/reference/release-notes/1.23.2.md index eb96a1f4..e03a9cdc 100644 --- a/reference/release-notes/1.23.2.md +++ b/reference/release-notes/1.23.2.md @@ -45,14 +45,14 @@ The Anbox Cloud 1.23.2 release includes fixes from the respective upstreams for | CVE | Affected Components | |-----|---------------------| -| CVE-2024-40674 | Android 14 | -| CVE-2024-40677 | Android 12, 13, 14, 15 | -| CVE-2024-40672 | Android 12, 13, 14 | -| CVE-2024-40673 | Android 12, 13, 14 | -| CVE-2024-40675 | Android 12, 13, 14 | -| CVE-2024-40676 | Android 12, 13, 14, 15 | -| CVE-2024-0044 | Android 12, 13, 14, 15 | -| CVE-2024-47068 | Anbox Cloud web dashboard | +| [CVE-2024-40674](https://source.android.com/docs/security/bulletin/2024-10-01#System) | Android 14 | +| [CVE-2024-40677](https://source.android.com/docs/security/bulletin/2024-10-01#System) | Android 12, 13, 14, 15 | +| [CVE-2024-40672](https://source.android.com/docs/security/bulletin/2024-10-01#System) | Android 12, 13, 14 | +| [CVE-2024-40673](https://source.android.com/docs/security/bulletin/2024-10-01#System) | Android 12, 13, 14 | +| [CVE-2024-40675](https://source.android.com/docs/security/bulletin/2024-10-01#Framework) | Android 12, 13, 14 | +| [CVE-2024-40676](https://source.android.com/docs/security/bulletin/2024-10-01#Framework) | Android 12, 13, 14, 15 | +| [CVE-2024-0044](https://source.android.com/docs/security/bulletin/2024-10-01#Framework) | Android 12, 13, 14, 15 | +| [CVE-2024-47068](https://nvd.nist.gov/vuln/detail/CVE-2024-47068) | Anbox Cloud web dashboard | ## Bug fixes From 896caf3ed34789760b049911fbc4adb0292b6276 Mon Sep 17 00:00:00 2001 From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com> Date: Mon, 14 Oct 2024 08:07:00 +0000 Subject: [PATCH 04/16] chore(deps): update canonical/anbox-cloud-github-action digest to 118f33a --- .github/workflows/generate-command-reference.yml | 2 +- .github/workflows/update-api-specs.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/generate-command-reference.yml b/.github/workflows/generate-command-reference.yml index 7048deaf..7f2cf3b4 100644 --- a/.github/workflows/generate-command-reference.yml +++ b/.github/workflows/generate-command-reference.yml @@ -18,7 +18,7 @@ jobs: run: | echo "value=$(cat .base_version)" >> "$GITHUB_OUTPUT" - name: Set up Anbox Cloud - uses: canonical/anbox-cloud-github-action@39490d442cc0921fe614f7044b9f3dc8bd89725c + uses: canonical/anbox-cloud-github-action@118f33a9d428f1a42940333fad8ff108be757908 with: channel: ${{ steps.base_version.outputs.value }}/stable - name: Checkout repo diff --git a/.github/workflows/update-api-specs.yaml b/.github/workflows/update-api-specs.yaml index b7c27636..8445c1a8 100644 --- a/.github/workflows/update-api-specs.yaml +++ b/.github/workflows/update-api-specs.yaml @@ -16,7 +16,7 @@ jobs: run: | echo "value=$(cat .base_version)" >> "$GITHUB_OUTPUT" - name: Set up Anbox Cloud - uses: canonical/anbox-cloud-github-action@39490d442cc0921fe614f7044b9f3dc8bd89725c + uses: canonical/anbox-cloud-github-action@118f33a9d428f1a42940333fad8ff108be757908 with: channel: ${{ steps.base_version.outputs.value }}/stable - name: Determine appliance version From 2b0dc5b17d3fa153aa15846b457a4324100f7b82 Mon Sep 17 00:00:00 2001 From: Keirthana Date: Mon, 14 Oct 2024 17:57:23 +0530 Subject: [PATCH 05/16] Add versions for charms, bundles and snaps --- reference/component-versions.md | 33 +++++++++++++++++++++++++++++---- 1 file changed, 29 insertions(+), 4 deletions(-) diff --git a/reference/component-versions.md b/reference/component-versions.md index b2552e11..f20ae6c8 100644 --- a/reference/component-versions.md +++ b/reference/component-versions.md @@ -13,26 +13,51 @@ Not all components are updated with each release. When components are not update | Name | Channel | Revision | |----------|--------------|--------------| -| | | | +| `anbox-cloud-dashboard` | `1.23/stable` | 545 | +| `ams-node-controller` (Deprecated) | `1.23/stable` | 554 | +| `coturn` | `1.23/stable` | 547 | +| `ams` | `1.23/stable` | 619 | +| `anbox-stream-gateway` | `1.23/stable` | 573 | +| `ams-lxd` | `1.23/stable` | 550 | +| `anbox-stream-agent` | `1.23/stable` | 568 | +| `aar` | `1.23/stable` | 600 | +| `nats` | `latest/stable` | 9 (AMD64), 11 (ARM64) | #### Ubuntu 20.04 (Deprecated) | Name | Channel | Revision | |----------|--------------|--------------| -| | | | +| `anbox-cloud-dashboard` | `1.23/stable` | 544 | +| `ams-node-controller` (Deprecated) | `1.23/stable` | 553 | +| `coturn` | `1.23/stable` | 546 | +| `ams` | `1.23/stable` | 618 | +| `anbox-stream-gateway` | `1.23/stable` | 572 | +| `ams-lxd` | `1.23/stable` | 549 | +| `anbox-stream-agent` | `1.23/stable` | 567 | +| `aar` | `1.23/stable` | 599 | +| `nats` | `latest/stable` | 10 (AMD64), 12 (ARM64) | ### Bundles | Name | Channel | Revision | |----------|--------------|--------------| -| | | | +| `anbox-cloud` | `1.23/stable` | 434| +| `anbox-cloud-core` | `1.23/stable` | 443 | ### Snaps | Name | Channel | Version | |----------|--------------|---------| -| | | | +| `ams` | `1.23/stable` | `1.23.2-047136ecf` | +| `aar` | `1.23/stable` | `1.23.2-047136ecf` | +| `amc` | `latest/stable` | `1.23.2-047136ecf` | +| `ams-node-controller` (Deprecated) | `1.23/stable` | `1.23.2-047136ecf` | +| `anbox-cloud-dashboard` | `1.23/stable` | `1.23.2-047136ecf` | +| `anbox-stream-agent` | `1.23/stable` | `1.23.2-047136ecf` | +| `anbox-stream-gateway` | `1.23/stable` | `1.23.2-047136ecf` | +| `anbox-connect` | `latest/stable` | `1.23.2-047136ecf` | +| `anbox-cloud-appliance` | `1.23/stable` | `1.23.2-047136ecf` | ### Anbox images From a395f240ff6b4e5325d5832c99e537d4276765d7 Mon Sep 17 00:00:00 2001 From: Keirthana Date: Tue, 15 Oct 2024 12:37:20 +0530 Subject: [PATCH 06/16] Apply review feedback --- reference/release-notes/1.23.2.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/reference/release-notes/1.23.2.md b/reference/release-notes/1.23.2.md index e03a9cdc..4a793dc8 100644 --- a/reference/release-notes/1.23.2.md +++ b/reference/release-notes/1.23.2.md @@ -46,13 +46,13 @@ The Anbox Cloud 1.23.2 release includes fixes from the respective upstreams for | CVE | Affected Components | |-----|---------------------| | [CVE-2024-40674](https://source.android.com/docs/security/bulletin/2024-10-01#System) | Android 14 | -| [CVE-2024-40677](https://source.android.com/docs/security/bulletin/2024-10-01#System) | Android 12, 13, 14, 15 | +| [CVE-2024-40677](https://source.android.com/docs/security/bulletin/2024-10-01#System) | Android 12, 13, 14 | | [CVE-2024-40672](https://source.android.com/docs/security/bulletin/2024-10-01#System) | Android 12, 13, 14 | | [CVE-2024-40673](https://source.android.com/docs/security/bulletin/2024-10-01#System) | Android 12, 13, 14 | | [CVE-2024-40675](https://source.android.com/docs/security/bulletin/2024-10-01#Framework) | Android 12, 13, 14 | -| [CVE-2024-40676](https://source.android.com/docs/security/bulletin/2024-10-01#Framework) | Android 12, 13, 14, 15 | -| [CVE-2024-0044](https://source.android.com/docs/security/bulletin/2024-10-01#Framework) | Android 12, 13, 14, 15 | -| [CVE-2024-47068](https://nvd.nist.gov/vuln/detail/CVE-2024-47068) | Anbox Cloud web dashboard | +| [CVE-2024-40676](https://source.android.com/docs/security/bulletin/2024-10-01#Framework) | Android 12, 13, 14| +| [CVE-2024-0044](https://source.android.com/docs/security/bulletin/2024-10-01#Framework) | Android 12, 13, 14 | +| [CVE-2024-47068](https://nvd.nist.gov/vuln/detail/CVE-2024-47068) | Anbox Cloud Dashboard, Anbox Cloud Appliance | ## Bug fixes From deb85114fdae656ccf1f39abe9e99e7025facd49 Mon Sep 17 00:00:00 2001 From: Keirthana Date: Tue, 15 Oct 2024 12:50:51 +0530 Subject: [PATCH 07/16] Add image versions --- reference/component-versions.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/reference/component-versions.md b/reference/component-versions.md index f20ae6c8..4460e9ad 100644 --- a/reference/component-versions.md +++ b/reference/component-versions.md @@ -65,12 +65,12 @@ The following Anbox images are available in two variants: one based on a contain | Name | Version | |----------|--------------| -| `jammy:android13:amd64` | | -| `jammy:android13:arm64` | | -| `jammy:android12:amd64` | | -| `jammy:android12:arm64` | | -| `jammy:aaos13:amd64` | | -| `jammy:aaos13:arm64` | | +| `jammy:android13:amd64` | `1.23.2-20241012130214.git273ce8dc2` | +| `jammy:android13:arm64` | `1.23.2-20241012130214.git273ce8dc2` | +| `jammy:android12:amd64` | `1.23.2-20241012130214.git273ce8dc2` | +| `jammy:android12:arm64` | `1.23.2-20241012130214.git273ce8dc2` | +| `jammy:aaos13:amd64` | `1.23.2-20241012130214.git273ce8dc2` | +| `jammy:aaos13:arm64` | `1.23.2-20241012130214.git273ce8dc2` | ## 1.23.1 From 2c1bc3376e991fc25201b24b867809846ba1cd00 Mon Sep 17 00:00:00 2001 From: Keirthana Date: Wed, 16 Oct 2024 12:54:48 +0530 Subject: [PATCH 08/16] Update bundle revisions --- reference/component-versions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/component-versions.md b/reference/component-versions.md index 4460e9ad..a9e60560 100644 --- a/reference/component-versions.md +++ b/reference/component-versions.md @@ -42,8 +42,8 @@ Not all components are updated with each release. When components are not update | Name | Channel | Revision | |----------|--------------|--------------| -| `anbox-cloud` | `1.23/stable` | 434| -| `anbox-cloud-core` | `1.23/stable` | 443 | +| `anbox-cloud` | `1.23/stable` | 442| +| `anbox-cloud-core` | `1.23/stable` | 451 | ### Snaps From 54600bdf5b6690ad11655f2f16cf196ea3b27f72 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 17 Oct 2024 01:33:46 +0000 Subject: [PATCH 09/16] feat: update API specs from 1.23.2-047136ecf --- reference/api-reference/ams-api.yaml | 257 +++++++++++++++++++++------ 1 file changed, 202 insertions(+), 55 deletions(-) diff --git a/reference/api-reference/ams-api.yaml b/reference/api-reference/ams-api.yaml index 721a041c..ffd6f5e0 100644 --- a/reference/api-reference/ams-api.yaml +++ b/reference/api-reference/ams-api.yaml @@ -1150,79 +1150,127 @@ paths: default: '' example: foobar agent.api.url: - description: URL for stream agent API endpoint + description: URL for stream agent API endpoint. type: string default: '' example: https://foo.bar:9001 application.addons: - description: Enable addons globally for applications + description: 'Comma-separated list of addons that every + + application managed by AMS will use.' type: string default: '' + x-docs-ref: howto-enable-addons-globally example: my-addon application.auto_publish: - description: Automatically publish the latest version for - an application + description: 'If set to `true`, AMS automatically published + + new application versions when the bootstrap + + process is finished. `false` disables this.' type: boolean default: true + x-docs-ref: sec-publish-app-versions application.auto_update: - description: Automatically update the images and applications - to the latest versions + description: 'If set to `true`, AMS automatically updates + + applications whenever any dependencies + + (parent image, addons, global configuration) change. + + `false` disables this.' type: boolean default: true + x-docs-ref: sec-configure-automatic-app-updates application.default_abi: - description: Set a default support ABI architecture globally + description: 'Default Android ABI that applications + + should use. See [Android ABIs](https://developer.android.com/ndk/guides/abis) + + for a list of available ABIs.' type: string default: '' example: arm64-v8a application.max_published_versions: - description: Set the maximum number of application versions - to publish + description: 'Maximum number of published versions per + + application. If the number of versions of + + an application exceeds this configuration, + + AMS will automatically clean up older versions.' type: integer format: int32 default: 3 example: 3 container.apt_mirror: - description: APT mirror to use for downloading dependencies - inside the container + description: '*(Deprecated)* APT mirror to use within + + the containers. This configuration item + + is deprecated since 1.20, use `instance.apt_mirror` + + instead.' type: string default: '' + x-deprecated-since: '1.20' example: http://ports.ubuntu.com/ubuntu-ports container.default_platform: - description: Platform to be forwarded to the container for - running audio/video operations + description: '*(Deprecated)* The name of the platform + + that Anbox Cloud uses by default to launch + + containers. This configuration item is deprecated + + since 1.20, use `instance.default_platform` instead.' type: string default: 'null' enum: - 'null' - webrtc - swrast + x-deprecated-since: '1.20' example: webrtc container.features: - description: Enable additional android features + description: '"*(Deprecated)* Comma-separated list of + + features to enable. This configuration + + item is deprecated since 1.20, use `instance.features` + + instead."' type: string default: '' + x-deprecated-since: '1.20' example: enable_virtual_keyboard,foo container.security_updates: - description: Enable/disable security update for containers + description: '*(Deprecated)* If set to `true`, automatic Ubuntu + security updates are applied during the application bootstrap + process. `false` disables this.' type: boolean default: true + x-deprecated-since: '1.20' core.debug_address: description: Address used to expose debug information on type: string default: '' example: https://127.0.0.1:9090 core.proxy_http: - description: Proxy variables inside container + description: HTTP proxy to use for HTTP requests that AMS + performs. type: string default: '' example: http://my-proxy:8000 core.proxy_https: - description: Proxy variables inside container + description: HTTPS proxy to use for HTTPS requests that AMS + performs. type: string default: '' example: http://my-proxy:8000 core.proxy_ignore_hosts: - description: Proxy variables inside container + description: 'Comma-separated list that defines the hosts + + for which a configured proxy is not used.' type: string default: '' example: localhost,127.0.0.1 @@ -1236,15 +1284,26 @@ paths: default: '' example: sUp3rS3cR3t cpu.limit_mode: - description: CPU limiting strategies used for a container + description: 'The mode AMS uses to limit CPU access + + for an instance. Possible values are: + + `scheduler`, `pinning`.' type: string default: scheduler enum: - scheduler - pinning + x-docs-ref: exp-performance example: scheduler gpu.allocation_mode: - description: GPU allocation mode + description: 'Method of allocating GPUs: `all` tells + + AMS to allocate all available GPUs on a + + system to an instance. `single` allocates + + only a single GPU.' type: string default: single enum: @@ -1252,8 +1311,7 @@ paths: - single example: single gpu.type: - description: GPU type. Can be `none`, `nvidia`, `intel` or - `amd` + description: 'Type of GPU: `none`, `intel`, `nvidia`, `amd`' type: string default: none enum: @@ -1263,38 +1321,58 @@ paths: - intel example: none images.allow_insecure: - description: Allow insecure TLS for accessing image registry + description: 'If set to `true`, AMS allows accepting + + untrusted certificates provided by the + + configured image server."' type: boolean default: false images.auth: - description: Auth token required to access the image registry + description: 'Authentication details for AMS to access + + the image server. When reading this configuration, + + a Boolean value that indicates whether the item + + is set is returned, to avoid exposing credentials.' type: string default: '' example: user:password images.update_interval: - description: Interval used to check for image updates + description: 'Frequency of image updates (for example: 1h, + 30m).' type: string default: 5m example: 5m images.url: - description: Image registry URL + description: URL of the image server to use. type: string default: https://images.anbox-cloud.io/stable/ example: https://images.anbox-cloud.io/stable/ images.version_lockstep: - description: Lock latest image version to align with latest - AMS version + description: 'Whether to put the version of the latest + + pulled image and the AMS version in a lockstep. + + This ensures that a deployment is not automatically + + updated to newer image versions if AMS is still at + + an older version. This only applies for new major + + and minor but not patch version updates.' type: boolean default: true instance.apt_mirror: - description: APT mirror to use for downloading dependencies - inside the instance + description: APT mirror to use within the instances. type: string default: '' example: http://ports.ubuntu.com/ubuntu-ports instance.default_platform: - description: Platform to be forwarded to the instance for - running audio/video operations + description: 'The name of the platform that Anbox Cloud + + uses by default to launch instances.' type: string default: 'null' enum: @@ -1303,64 +1381,124 @@ paths: - swrast example: webrtc instance.features: - description: Enable additional android features + description: Comma-separated list of features to enable. type: string default: '' example: enable_virtual_keyboard,foo + instance.network_proxy: + description: 'Network proxy to use inside the instances. + + This value must have the format `:`' + type: string + default: '' + example: myproxy.com:9090 instance.security_updates: - description: Enable/disable security update for instance + description: 'If set to `true`, automatic Ubuntu security + + updates are applied during the application + + bootstrap process. `false` disables this.' type: boolean default: true load_balancer.url: - description: Set host URL for AMS to loadbalancer's URL + description: 'URL of the load balancer behind which AMS sits. + + The URL is handed to instances started by AMS to + + allow them to contact AMS through the load balancer + + and not via the address of an individual AMS instance.' type: string default: '' example: https://load-balanced-ams.com node.queue_size: - description: Queue size for internal AMS workers + description: 'Maximum size of the queue containing requests + + to start and stop instances per LXD node. + + Changing the value requires a restart of AMS.' type: integer format: int32 default: 100 example: 100 node.workers_per_queue: - description: Number of internal workers for AMS + description: 'Number of workers processing instance start + + and stop requests. Changing the value requires + + a restart of AMS.' type: integer format: int32 default: 4 example: 4 registry.filter: - description: Tag filters used for selecting applications when - interacting with the registry + description: 'Comma-separated list of tags to filter + + for when applications are fetched from + + aar. If empty, no filter is applied.' type: string default: '' + x-docs-ref: exp-aar example: foo,bar registry.fingerprint: - description: Fingerprint used to verify the ceritifcate of - the application registry + description: 'Fingerprint of the certificate that the + + AAR uses to TLS-secure its HTTPS endpoint. + + This is used by AMS for mutual TLS authentication + + with the registry.' type: string default: '' + x-docs-ref: exp-aar example: my-registry-fingerprint registry.mode: - description: Mode used to interact with the registry + description: 'Mode in which the AAR client in AMS + + operates: `manual`, `pull`, `push`.' type: string default: pull enum: - push - pull - manual + x-docs-ref: exp-aar example: pull registry.update_interval: - description: Interval used for checking for updates to applications + description: 'Frequency of AAR updates (for example: 1h, 30m).' type: string default: 1h + x-docs-ref: exp-aar example: 1h registry.url: - description: Application registry URL + description: URL of the AAR to use. type: string default: '' + x-docs-ref: exp-aar example: https://foo.bar/ scheduler.strategy: - description: Container scheduling startegy + description: 'Strategy that the internal instance scheduler + + in AMS uses to distribute instances across + + available LXD nodes: `binpack`, `spread`
+ + Choose a scheduling strategy that best suits + + your needs:
- `spread` provides a distributed + + workload, picking the node with the most + + free resources.
- `binpack` is useful + + when you are working with a small cluster + + as it picks the node that is most used + + until it is out of capacity before moving + + on to the next node.' type: string default: spread enum: @@ -5193,19 +5331,27 @@ definitions: type: object properties: cpu_allocation_rate: - description: Update the CPU allocation rate for the node + description: CPU allocation rate used for over-committing resources type: number format: float + x-docs-ref: sec-over-committing example: 4 cpus: - description: Update the number of CPUs for the node + description: Number of CPUs dedicated to instances. type: integer format: int64 example: 4 gpu_encoder_slots: - description: Update the number of GPU encoder slots to configure on the node + description: 'Number of GPU encoder slots available on the node. + + `0` for nodes without GPU + + `32` for nodes with NVIDIA GPU + + `10` for nodes with AMD or Intel GPU' type: integer format: int64 + x-docs-ref: sec-gpu-slots example: 4 gpu_slots: description: Update the number of GPU slots to configure on the node @@ -5221,23 +5367,23 @@ definitions: type: string example: 2GB memory_allocation_rate: - description: Update the memory allocation rate for the node + description: Memory allocation rate used for over-committing resources. type: number format: float + x-docs-ref: sec-over-committing example: 2 public_address: - description: Update the public IP Address of the node + description: The public, reachable address of the node. type: string format: ipv4 example: 10.0.0.1 subnet: - description: Update the subnet info of the node if the subnet of a node is - changed + description: The network subnet of the machine where the node runs. type: string format: ipv4 example: 10.0.0.1/24 tags: - description: Update the tags of the node + description: Tags to identify the node. type: array items: type: string @@ -5247,10 +5393,11 @@ definitions: unscheduable: description: DEPRECATED Flag in favour of `unschedulable` flag type: boolean + x-deprecated-since: '1.20' example: false unschedulable: - description: Flag used to remove the node from scheduler and not schedule - containers on it + description: When set to `true`, the node cannot be scheduled, which prevents + new instances from being launched on it. type: boolean example: true NodeStatus: From f2539fabe96a2e3e75148027863b8711b9be3e3c Mon Sep 17 00:00:00 2001 From: Keirthana Date: Thu, 17 Oct 2024 11:46:02 +0530 Subject: [PATCH 10/16] Fix message around custom images and image server --- reference/provided-images.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/provided-images.md b/reference/provided-images.md index dedd0b39..80a13266 100644 --- a/reference/provided-images.md +++ b/reference/provided-images.md @@ -3,7 +3,7 @@ Anbox Cloud provides images based on different Android versions and different architectures (amd64, arm64). Anbox Management Service (AMS) manages these images, which can be individually selected by applications. When an image is updated, all applications using the image are automatically updated and rebased on the new image version. -Anbox Cloud images are regular [Ubuntu cloud images](https://cloud-images.ubuntu.com/) where Anbox Cloud and its dependencies are installed. Unnecessary packages are removed to improve images size, boot time and security. Officially released images are available from the [official image server](https://images.anbox-cloud.io) hosted by Canonical. It is currently not possible to build custom images for Anbox Cloud. +Anbox Cloud images are regular [Ubuntu cloud images](https://cloud-images.ubuntu.com/) where Anbox Cloud and its dependencies are installed. Unnecessary packages are removed to improve images size, boot time and security. Officially released images are available from the official image server hosted by Canonical at `https://images.anbox-cloud.io`. For information on custom Anbox Cloud images, see {ref}`exp-custom-images`. ## Supported Anbox Cloud images From 5375e26e791886ad667990759af43bff42d39af3 Mon Sep 17 00:00:00 2001 From: Keirthana Date: Thu, 17 Oct 2024 12:17:05 +0530 Subject: [PATCH 11/16] Fix ignore list for spellcheck --- .custom_wordlist.txt | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/.custom_wordlist.txt b/.custom_wordlist.txt index a10b5f8b..b261bded 100644 --- a/.custom_wordlist.txt +++ b/.custom_wordlist.txt @@ -1,21 +1,20 @@ -AAM -AAOS +aam +aaos AAPT -AAR +aar AArch ABI ABIs ACLs -ADB +adb addon addons allocator Altra -AMC +amc amd AMI -AMS -Anbox +ams anbox anonymization ANR @@ -130,12 +129,13 @@ HIDL HMAC Honkai hotfix -HTTPS +https HW HWE HVAC IAM idmapped +io IDR IME impactful @@ -326,7 +326,7 @@ VNC VNDK VPC VPN -VPU +vpu VPUs vsync Vulkan From 8ee13828dbd3d0bf99eb75e879d6e685e1eb99ca Mon Sep 17 00:00:00 2001 From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com> Date: Tue, 22 Oct 2024 11:33:21 +0000 Subject: [PATCH 12/16] chore(deps): update canonical/anbox-cloud-github-action digest to 1313af2 --- .github/workflows/generate-command-reference.yml | 2 +- .github/workflows/update-api-specs.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/generate-command-reference.yml b/.github/workflows/generate-command-reference.yml index 7f2cf3b4..7b3785c7 100644 --- a/.github/workflows/generate-command-reference.yml +++ b/.github/workflows/generate-command-reference.yml @@ -18,7 +18,7 @@ jobs: run: | echo "value=$(cat .base_version)" >> "$GITHUB_OUTPUT" - name: Set up Anbox Cloud - uses: canonical/anbox-cloud-github-action@118f33a9d428f1a42940333fad8ff108be757908 + uses: canonical/anbox-cloud-github-action@1313af204abc19f4ba5f655d3d0717eba2516c6f with: channel: ${{ steps.base_version.outputs.value }}/stable - name: Checkout repo diff --git a/.github/workflows/update-api-specs.yaml b/.github/workflows/update-api-specs.yaml index 8445c1a8..c7db2e19 100644 --- a/.github/workflows/update-api-specs.yaml +++ b/.github/workflows/update-api-specs.yaml @@ -16,7 +16,7 @@ jobs: run: | echo "value=$(cat .base_version)" >> "$GITHUB_OUTPUT" - name: Set up Anbox Cloud - uses: canonical/anbox-cloud-github-action@118f33a9d428f1a42940333fad8ff108be757908 + uses: canonical/anbox-cloud-github-action@1313af204abc19f4ba5f655d3d0717eba2516c6f with: channel: ${{ steps.base_version.outputs.value }}/stable - name: Determine appliance version From 32de6d2099271826433a8f6d1b2f5168fdd1e090 Mon Sep 17 00:00:00 2001 From: Simon Fels Date: Wed, 23 Oct 2024 13:57:00 +0200 Subject: [PATCH 13/16] feat: add release notes for 1.23.2 hotfix 1 --- reference/component-versions.md | 4 ++-- reference/release-notes/1.23.2-hotfix1.md | 14 ++++++++++++++ reference/release-notes/release-notes.md | 3 ++- 3 files changed, 18 insertions(+), 3 deletions(-) create mode 100644 reference/release-notes/1.23.2-hotfix1.md diff --git a/reference/component-versions.md b/reference/component-versions.md index a9e60560..8c6262f2 100644 --- a/reference/component-versions.md +++ b/reference/component-versions.md @@ -18,7 +18,7 @@ Not all components are updated with each release. When components are not update | `coturn` | `1.23/stable` | 547 | | `ams` | `1.23/stable` | 619 | | `anbox-stream-gateway` | `1.23/stable` | 573 | -| `ams-lxd` | `1.23/stable` | 550 | +| `ams-lxd` | `1.23/stable` | 566 | | `anbox-stream-agent` | `1.23/stable` | 568 | | `aar` | `1.23/stable` | 600 | | `nats` | `latest/stable` | 9 (AMD64), 11 (ARM64) | @@ -33,7 +33,7 @@ Not all components are updated with each release. When components are not update | `coturn` | `1.23/stable` | 546 | | `ams` | `1.23/stable` | 618 | | `anbox-stream-gateway` | `1.23/stable` | 572 | -| `ams-lxd` | `1.23/stable` | 549 | +| `ams-lxd` | `1.23/stable` | 565 | | `anbox-stream-agent` | `1.23/stable` | 567 | | `aar` | `1.23/stable` | 599 | | `nats` | `latest/stable` | 10 (AMD64), 12 (ARM64) | diff --git a/reference/release-notes/1.23.2-hotfix1.md b/reference/release-notes/1.23.2-hotfix1.md new file mode 100644 index 00000000..fdda341a --- /dev/null +++ b/reference/release-notes/1.23.2-hotfix1.md @@ -0,0 +1,14 @@ +--- +orphan: true +--- +# 1.23.2 hotfix 1 + +These release notes are for a hotfix release for Anbox Cloud 1.23.2 to work around the [LP #2083961](https://bugs.launchpad.net/snapd/+bug/2083961) bug in [snapd](https://github.com/canonical/snapd). + +The only updated component is the [`ams-lxd` charm](https://charmhub.io/ams-lxd). The version of the updated charm is `1.23.2-40ab511`. You can find the updated list of component versions for the 1.23.2 at {ref}`ref-component-versions` . + +The fixed problem manifests itself in the `ams-lxd` charm running into error status when trying to perform a reload of the `lxd.daemon` systemd service unit. The charm invokes `snap restart --reload lxd.daemon` for this which causes a failure on the systemd side as it is attempting to restart more than the necessary units. In order to mitigate the problem, until it is fixed in snapd, the `ams-lxd` charm has been updated to reload LXD by running `systemctl reload-or-restart snap.lxd.daemon.service` instead. + +## Upgrade instructions + +See {ref}`howto-upgrade-anbox-cloud` and {ref}`howto-upgrade-appliance` for instructions on how to update your Anbox Cloud deployment to the 1.23.2 release. diff --git a/reference/release-notes/release-notes.md b/reference/release-notes/release-notes.md index 6dc9f988..945767b6 100644 --- a/reference/release-notes/release-notes.md +++ b/reference/release-notes/release-notes.md @@ -9,6 +9,7 @@ For instructions on how to update your Anbox Cloud deployment to later versions, | Release date | Release notes | |----|----| +| October 23 2023 | [Anbox Cloud 1.23.2 hotfix 1](1.23.2-hotfix1.md) | | October 16 2023 | [Anbox Cloud 1.23.2](1.23.2.md) | | September 18 2024 | [Anbox Cloud 1.23.1](1.23.1.md) | | August 14 2024 | [Anbox Cloud 1.23.0](1.23.0.md) | @@ -35,7 +36,7 @@ Minor releases Patch releases : A patch release for Anbox Cloud is released every month and includes Android and Chrome security updates alongside Anbox Cloud specific bug fixes. -Anbox Cloud currently officially supports only the most recent release. Older releases are only supported for a short time after a new minor release was published. +Anbox Cloud currently officially supports only the most recent release. Older releases are only supported for a short time after a new minor release was published. Feature deprecations are generally announced two releases in advance before the deprecated features are dropped. See {ref}`ref-deprecation-notes` for details. From dbc209e4c004a7640e3947490bfe92668dff032b Mon Sep 17 00:00:00 2001 From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com> Date: Wed, 23 Oct 2024 20:00:28 +0000 Subject: [PATCH 14/16] chore(deps): update actions/checkout digest to 11bd719 --- .github/workflows/generate-command-reference.yml | 2 +- .github/workflows/update-api-specs.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/generate-command-reference.yml b/.github/workflows/generate-command-reference.yml index 7b3785c7..36b14781 100644 --- a/.github/workflows/generate-command-reference.yml +++ b/.github/workflows/generate-command-reference.yml @@ -22,7 +22,7 @@ jobs: with: channel: ${{ steps.base_version.outputs.value }}/stable - name: Checkout repo - uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871 # v4 + uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4 # Remove existing files, generate AMC command reference - name: Generate AMC command reference documentation run: | diff --git a/.github/workflows/update-api-specs.yaml b/.github/workflows/update-api-specs.yaml index c7db2e19..078faf7b 100644 --- a/.github/workflows/update-api-specs.yaml +++ b/.github/workflows/update-api-specs.yaml @@ -10,7 +10,7 @@ jobs: runs-on: ubuntu-24.04 steps: - name: Check out repository - uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871 # v4 + uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4 - name: Determine base version id: base_version run: | From cd4fe20c628b024edbff85b25035e0fc5a07d536 Mon Sep 17 00:00:00 2001 From: gary-wzl77 Date: Thu, 24 Oct 2024 15:23:52 +0800 Subject: [PATCH 15/16] fix(anbox-https-api); fix the invalid json based post body --- reference/api-reference/anbox-https-api.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/api-reference/anbox-https-api.md b/reference/api-reference/anbox-https-api.md index 0081d089..fa1e926b 100644 --- a/reference/api-reference/anbox-https-api.md +++ b/reference/api-reference/anbox-https-api.md @@ -603,7 +603,7 @@ Example input: "float_values": [], # (Optional) Float array "int32_values": [], # (Optional) 32-bit signed integer array "int64_values": [], # (Optional) 64-bit signed integer array - "string_value": "Foo", # (Optioanl) UTF-8 string + "string_value": "Foo" # (Optional) UTF-8 string } ``` @@ -741,4 +741,4 @@ Example return value for `curl -s -X GET --unix-socket /run/user/1000/anbox/sock See the [VHAL property configuration](https://source.android.com/docs/automotive/vhal/property-configuration) for more information on these fields. -`value_type` is added as a convenience in the Anbox API and maps to the [VHAL property types](https://source.android.com/docs/automotive/vhal/property-configuration#property-types). \ No newline at end of file +`value_type` is added as a convenience in the Anbox API and maps to the [VHAL property types](https://source.android.com/docs/automotive/vhal/property-configuration#property-types). From 82be7f4eae95cf6d11d9e79e508daa7d03a262c4 Mon Sep 17 00:00:00 2001 From: Alexis Janon Date: Fri, 25 Oct 2024 11:49:09 +0200 Subject: [PATCH 16/16] fix(reference): add more features to the unsupported list for AAOS Some features were not listed as unsupported for AAOS, but they are. Fix this by adding them to the table and explaining how it works for AAOS. --- reference/anbox-features.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/reference/anbox-features.md b/reference/anbox-features.md index 7cd9d5d4..5df71ae9 100644 --- a/reference/anbox-features.md +++ b/reference/anbox-features.md @@ -10,6 +10,9 @@ The following table lists some Anbox features and whether they are supported for | boot-package and boot-activity in {ref}`ref-application-manifest` | ✓ | - | | {ref}`howto-install-apk-system-app` | ✓ | - | | [Custom Android ID](#custom-android-id) | ✓ | - | +| [System UI](#system-ui) | ✓ | - | +| [Virtual Keyboard](#virtual-keyboard) | ✓ | - | +| [Client-Side Virtual Keyboard](#client-side-virtual-keyboard) | ✓ | - | | {ref}`VHAL HTTP API ` | - | ✓ | | [VhalConnector](https://canonical.github.io/anbox-cloud.github.com/latest/anbox-platform-sdk/classanbox_1_1VhalConnector.html) in Platform SDK API | - | ✓ | | {ref}`exp-custom-images` | - | ✓ | @@ -33,23 +36,27 @@ To configure a feature for one application in the manifest, use a syntax similar ### System UI -*since 1.10.2* +*since 1.10.2, supported on AOSP images only* By default, Anbox hides the Android system UI when an application is running in foreground mode. In some use cases, however, it's required to have the system UI available for navigation purposes. This can be enabled with the `enable_system_ui` feature flag. The feature flag will be considered by all new launched instances once set. +On AAOS, the Android Car system UI is always enabled and cannot be disabled. + ### Virtual Keyboard -*since 1.9.0* +*since 1.9.0, supported on AOSP images only* The Android virtual keyboard is disabled by default but can be enabled with the `enable_virtual_keyboard` feature flag. For the feature to be considered, applications must be manually updated, because changes to allow the feature to work are only applied during the application {ref}`bootstrap process `. +On AAOS, the Android virtual keyboard is always enabled and cannot be disabled. + ### Client-Side Virtual Keyboard -*since 1.11.0* +*since 1.11.0, supported on AOSP images only* The client-side virtual keyboard is disabled by default but can be enabled with the `enable_anbox_ime` feature flag. It requires the client application to embed {ref}`Anbox WebView ` which interacts with the client-side virtual keyboard for text editing and sends the text to the Android container.