From f9939aba030b7f50dddf6271270db20f2897dd5b Mon Sep 17 00:00:00 2001 From: Paul Podgorsek Date: Mon, 18 Sep 2023 09:25:27 +0200 Subject: [PATCH 1/3] Issue #443 - Add notes to documentation explaining what architectures are supported --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/README.md b/README.md index 6c30429..b981488 100644 --- a/README.md +++ b/README.md @@ -280,6 +280,22 @@ It is anyway mandatory to extend the container image to install the specific dat * [Oracle](https://www.oracle.com/uk/database/technologies/appdev/python.html): `pip install py2oracle` * [PostgreSQL](http://pybrary.net/pg8000/index.html): `pip install pg8000` +### Supported devices and architectures + +As mentioned on the [Docker Hub](https://hub.docker.com/r/ppodgorsek/robot-framework), the project has been built and uploaded as a linux/amd64 image. This means ARM devices won't be able to run the image with the default configuration. + +Podman and Docker provide a `--platform` option which emulates a given application architecture, such as: + + docker run \ + --platform linux/amd64 \ + -v :/opt/robotframework/reports:Z \ + -v :/opt/robotframework/tests:Z \ + ppodgorsek/robot-framework: + +Please note: such emulation might not work, depending on your device and operating system. + +If this does not solve your platform-related issues, you will have to rebuild the image for your device/platform. + ## Please contribute! Have you found an issue? Do you have an idea for an improvement? Feel free to contribute by submitting it [on the GitHub project](https://github.com/ppodgorsek/docker-robot-framework/issues). From e1c257b9a06f28b00f244e22ee67cd84364d76bc Mon Sep 17 00:00:00 2001 From: Paul Podgorsek Date: Mon, 18 Sep 2023 09:26:34 +0200 Subject: [PATCH 2/3] Issue #443 - Add notes to documentation explaining what architectures are supported --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b981488..da41d05 100644 --- a/README.md +++ b/README.md @@ -282,7 +282,7 @@ It is anyway mandatory to extend the container image to install the specific dat ### Supported devices and architectures -As mentioned on the [Docker Hub](https://hub.docker.com/r/ppodgorsek/robot-framework), the project has been built and uploaded as a linux/amd64 image. This means ARM devices won't be able to run the image with the default configuration. +As mentioned on the [Docker Hub](https://hub.docker.com/r/ppodgorsek/robot-framework), the project has been built and uploaded as a `linux/amd64` image. This means ARM devices won't be able to run the image with the default configuration. Podman and Docker provide a `--platform` option which emulates a given application architecture, such as: From 789e09bc79ad3c662aa61112b9b8ab722538ff3e Mon Sep 17 00:00:00 2001 From: Paul Podgorsek Date: Mon, 18 Sep 2023 10:04:11 +0200 Subject: [PATCH 3/3] Issue #443 - Add notes to documentation explaining what architectures are supported --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index da41d05..b4f634d 100644 --- a/README.md +++ b/README.md @@ -282,9 +282,9 @@ It is anyway mandatory to extend the container image to install the specific dat ### Supported devices and architectures -As mentioned on the [Docker Hub](https://hub.docker.com/r/ppodgorsek/robot-framework), the project has been built and uploaded as a `linux/amd64` image. This means ARM devices won't be able to run the image with the default configuration. +As mentioned on the [Docker Hub](https://hub.docker.com/r/ppodgorsek/robot-framework), the project has been built and uploaded as a `linux/amd64` image only. This means ARM devices such as MacBook M1/M2 and Amazon EC2 Graviton won't be able to run the image with the default configuration. -Podman and Docker provide a `--platform` option which emulates a given application architecture, such as: +As mentioned in the official documentation, [Podman](https://docs.podman.io/en/latest/markdown/podman-run.1.html#platform-os-arch) and [Docker](https://docs.docker.com/build/building/multi-platform/) provide a `--platform` option which selects a given application architecture, such as: docker run \ --platform linux/amd64 \ @@ -292,9 +292,9 @@ Podman and Docker provide a `--platform` option which emulates a given applicati -v :/opt/robotframework/tests:Z \ ppodgorsek/robot-framework: -Please note: such emulation might not work, depending on your device and operating system. +Please note: builds and automated tests of this project will remain performed on a `linux/amd64` architecture so such emulation might not work, depending on your device and operating system. -If this does not solve your platform-related issues, you will have to rebuild the image for your device/platform. +If this does not solve your platform-related issues, you will have to rebuild the image for your device/platform, specifying that `--platform` option during the build and run. ## Please contribute!