Discontinue official Docker images of Solidity

Author: cameel

.circleci/config.yml

@@ -1847,22 +1847,6 @@ jobs:
       - matrix_notify_failure_unless_pr
       - matrix_notify_release_unless_pr
 
-  b_alpine_docker:
-    <<: *base_cimg_small
-    steps:
-      - setup_remote_docker:
-          # Always build from scratch to use current packages.
-          # This job is only meant to run nightly so build time is not an issue.
-          docker_layer_caching: false
-      - checkout
-      - run:
-          name: Build and tag the container
-          command: scripts/docker_deploy_manual.sh develop "file://$PWD" --no-push
-      - run:
-          name: Smoke test
-          command: docker run --pull=never ethereum/solc:build-alpine --version
-      - matrix_notify_failure_unless_pr
-
 workflows:
   version: 2
 
@@ -2047,9 +2031,6 @@ workflows:
       - b_ubu: *requires_nothing
       - t_ubu_soltest_deprecated_evm_versions: *requires_b_ubu
 
-      # Build in a Docker container (on Alpine Linux)
-      - b_alpine_docker: *requires_nothing
-
   nightly-ossfuzz:
 
     triggers:

Changelog.md

@@ -10,6 +10,7 @@ Bugfixes:
 * Yul Optimizer: Fix edge case in which invalid Yul code is produced by ExpressionSimplifier due to expressions being substituted that contain out-of-scope variables.
 
 Build System:
+* Docker: Discontinue DockerHub as a binary distribution channel.
 * Ubuntu PPA Packages: Discontinue the PPA as a binary distribution channel.
 * Update minimum version requirements of Boost to 1.83.0 for non-windows builds and of GCC and Clang to 13.3 and 18.1.3, respectively. Fixes infinite recursion on `boost::rational` comparison affecting compiler binaries built with GCC<14.0 and Boost<1.75.
 

ReleaseChecklist.md

@@ -3,8 +3,6 @@
 ### Requirements
 - [ ] GitHub account with access to [solidity](https://github.com/argotorg/solidity), [solc-js](https://github.com/argotorg/solc-js),
       [solc-bin](https://github.com/argotorg/solc-bin), [solidity-website](https://github.com/argotorg/solidity-website).
-- [ ] DockerHub account with push rights to the [`solc` image](https://hub.docker.com/r/ethereum/solc).
-- [ ] Ubuntu/Debian dependencies of the Docker script: `docker-buildx`.
 - [ ] [npm Registry](https://www.npmjs.com) account added as a collaborator for the [`solc` package](https://www.npmjs.com/package/solc).
 - [ ] Access to the [solidity_lang Twitter account](https://twitter.com/solidity_lang).
 - [ ] [Reddit](https://www.reddit.com) account that is at least 10 days old with a minimum of 20 comment karma (`/r/ethereum` requirements).
@@ -74,10 +72,6 @@ At least a day before the release:
 ### Homebrew and MacOS
 - [ ] Update the version and the hash (`sha256sum solidity_$VERSION.tar.gz`) in the [`solidity` formula in Homebrew core repository](https://github.com/Homebrew/homebrew-core/blob/master/Formula/s/solidity.rb).
 
-### Docker
-- [ ] Make sure `docker-buildx` is installed.
-- [ ] Run `./scripts/docker_deploy_manual.sh v$VERSION`.
-
 ### Release solc-js
 - [ ] Wait until solc-bin was properly deployed. You can test this via remix - a test run through remix is advisable anyway.
 - [ ] Increment the version number, create a pull request for that, merge it after tests succeeded.

docs/installing-solidity.rst

@@ -72,44 +72,13 @@ Please refer to the solc-js repository for instructions.
 Docker
 ======
 
-Docker images of Solidity builds are available using the ``solc`` image from the ``ethereum`` organization.
-Use the ``stable`` tag for the latest released version, and ``nightly`` for potentially unstable changes in the ``develop`` branch.
-
-The Docker image runs the compiler executable so that you can pass all compiler arguments to it.
-For example, the command below pulls the stable version of the ``solc`` image (if you do not have it already),
-and runs it in a new container, passing the ``--help`` argument.
-
-.. code-block:: bash
-
-    docker run ethereum/solc:stable --help
-
-.. note::
-
-    Specific compiler versions are supported as the Docker image tag such as ``ethereum/solc:0.8.23``.
-    We will be passing the ``stable`` tag here instead of specific version tag to ensure that users get
-    the latest version by default and avoid the issue of an out-of-date version.
-
-To use the Docker image to compile Solidity files on the host machine, mount a
-local folder for input and output, and specify the contract to compile. For example:
-
-.. code-block:: bash
-
-    docker run \
-        --volume "/tmp/some/local/path/:/sources/" \
-        ethereum/solc:stable \
-            /sources/Contract.sol \
-            --abi \
-            --bin \
-            --output-dir /sources/output/
-
-You can also use the standard JSON interface (which is recommended when using the compiler with tooling).
-When using this interface, it is not necessary to mount any directories as long as the JSON input is
-self-contained (i.e. it does not refer to any external files that would have to be
-:ref:`loaded by the import callback <initial-vfs-content-standard-json-with-import-callback>`).
-
-.. code-block:: bash
+Docker images of Solidity builds up to version 0.8.30 are available on DockerHub as ``ethereum/solc``.
+However, we have discontinued this distribution method and future versions will not be added there.
 
-    docker run ethereum/solc:stable --standard-json < input.json > output.json
+The images contain only a statically-linked compiler binary and were provided merely for convenience,
+as a way to download and manage multiple versions using Docker.
+On systems with Docker already installed this made it possible to use any version of the
+compiler with a simple ``docker run ethereum/solc:<version>`` command.
 
 Linux Packages
 ==============