Phase out vagrant and ppa

Author: pinepain

Dockerfile

@@ -1,4 +1,4 @@
-FROM pinepain/libv8:latest
+FROM phpv8/libv8:latest
 
 ARG PHP=7.2
 

Vagrantfile

@@ -2,33 +2,20 @@
 Release libv8
 *************
 
-We will start with building Ubuntu PPA first as it used in further CI process to validate that ``php-v8`` is not broken.
+Currently Docker is the recommended way to distribute and use both php-v8 and libv8 itself. We also support building
+``libv8`` in macOS with Homebrew via `phpv8/tap`_ tap.
 
 To track v8 changes you can use these links:
 
 * https://github.com/v8/v8/commits/master/include/v8.h - to keep track on v8 upstream changes
 * https://omahaproxy.appspot.com/ - to keep track v8 channel(version) heads and what version is used in chrome
 
-Building libv8
-==============
+Building docker image
+=====================
 
-#. **Skip this step if you are updating v8 patch release version.** To bump minor v8 version (e.g. from 6.3 to 6.4),
- create new ``libv8-X.Y`` PPA for new version. As V8 could be build for ``i386`` but only from ``amd64``, which is not how PPA
- works, it's also make sense to keep new PPA ``amd64``-only. Also we don't use ``i386`` so we don't want to worry about it.
-#. Update libv8 Makefile (``packaging/libv8/Makefile``) with new libv8 version by setting proper values in
- ``GIT_VERSION=X.Y.Z`` and ``NAME=libv8-X.Y`` variables.
-#. Commit changes with ``build libv8`` commit message and wait until libv8 PPA build done.
-
-After libv8 PPA build done
-==========================
-
-#. Copy fresh ``libv8-X.Y`` build packages from ``experimental`` (default target for all libv8 builds we trigger)
- to it ``libv8-X.Y`` PPA. Do not rebuild, just copy binaries.
-#. **Wait for packages copied and published!**
-#. Build `phpv8/libv8`_ docker image, tag it with the
- relevant v8 full version and push to Docker Hub.
+#. Build `phpv8/libv8`_ docker image, tag it with the relevant v8 full version and push to Docker Hub.
+ Hint: use ``Makefile``.
 #. You may want to set proper ``V8`` version in ``php-v8`` by updating it in ``.travis.yml``.
-#. Make sure you have proper ``V8`` version set in ``packaging/Dockerfile`` under ``V8`` constant.
 
 After docker images rebuilt/published
 =====================================
@@ -40,11 +27,8 @@ After docker images rebuilt/published
 #. Also, update references to v8 version in `php-v8`_/scripts/provision/provision.sh,
  it's normally could be done by replacing old version with new, e.g. ``6.3`` => ``6.4``.
 #. On every version bump update `php-v8`_ ``README.md`` file with proper min v8 version required/tested.
-#. If you use vagrant, re-provision your local development environment at this step to fetch/add new ``libv8`` version.
- It's generally a good idea to remove old ``libv8`` versions as well and remove their PPA from apt sources list at this point.
 #. **Make sure** you tested `php-v8`_ locally first before pushing to remote,
- upgrading v8 could be tricky as it may break BC even in patch releases (that's why we started to have separate
- PPAs for minor version to somehow couple with this issue in minor releases).
+ upgrading v8 could be tricky as it may break BC even in patch releases.
 #. Note, that doing all this in a separate branch and merging that later into master is a nice and safe idea
  (note, you may skip PR overhead and do fast-forward merge locally to master).
 #. Commit message should state that it is v8 version bump, e.g. ``Require libv8 >= X.Y.Z``
@@ -61,3 +45,4 @@ Building packages for macOS Homebrew
 
 .. _php-v8: https://github.com/phpv8/php-v8
 .. _phpv8/libv8: https://github.com/phpv8/dockerfiles/tree/master/libv8
+.. _phpv8/tap: https://github.com/phpv8/homebrew-tap

docs/development/release-libv8.rst

@@ -29,28 +29,7 @@ PECL release
 #. Run ``pecl package`` in your build machine (it's normally vagrant box used for ``php-v8`` development). It should create
  ``v8-X.Y.Z.tgz`` file.
 #. Log in to PECL and upload file from previous step at https://pecl.php.net/release-upload.php. Verify that release info
- is accurate and confirm release. 
-
-Ubuntu PPA release
-==================
-
-#. Copy targeted ``libv8-X.Y`` build to ``php`` ppa without rebuild, just copy.
-#. Make sure you have proper PHP and ``php-v8`` PPA dependencies set in https://launchpad.net/~pinepain/+archive/ubuntu/php-v8/+edit-dependencies
-#. Make sure you have proper ``php-v8`` version set in ``packaging/Dockerfile`` under ``V8`` constant.
-#. In ``packaging/php-v8/Makefile`` set proper ``VERSION=X.Y.Z``
-#. Make sure you have valid ``libv8`` dependency in ``packaging/php-v8/debian/control`` file.
-#. Commit changes with ``build php-v8`` commit message and wait until libv8 PPA build done.
-#. Copy ``php-v8`` packages to ``pinepain/php`` PPA, do not rebuild, just copy.
-#. After they get copied, feels free to remove **old** ``libv8`` packages from ``pinepain/php`` ppa.
-
-macOS Homebrew release
-======================
-
-#. Update ``php7*-v8`` formula **one by one** to have proper ``depends_on 'v8@X.Y'``
- and ``v8_prefix=Formula['v8@X.Y'].opt_prefix`` values.
-#. If you want to rebuild existent version, add/increment ``revision`` in formula body.
-#. If version has already been published to bintray and you absolutely sure it needs to be re-built without revision.
- bump, you will need to delete such version from bintray first.
+ is accurate and confirm release.
 
 Docker image release
 ====================
@@ -65,8 +44,7 @@ Docker image release
 After all
 =========
 
-#. Update `js-sandbox`_ ``.travis.yml`` and ``.scrutinizer.yml``
- to refer to new ``php-v8`` version and to relevant ``libv8`` PPA and packages.
+#. Update `js-sandbox`_ dependencies, if required, to use latest ``php-v8`` and other dependencies, if any.
 #. Update ``PHP_V8_VERSION`` to the next version and set ``PHP_V8_REVISION`` to ``dev`` in ``php_v8.h``.
 #. Commit changes with ``Back to dev [skip ci]`` message and push them to master.
 

docs/development/release-php-v8.rst

@@ -1,8 +1,6 @@
 Welcome to php-v8's documentation!
 ==================================
 
-.. include:: getting-started/donate.rst
-
 About
 =====