This is an automated email from the ASF dual-hosted git repository.
maximebeauchemin pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-superset.git
The following commit(s) were added to refs/heads/master by this push:
new 5375745 Improve release instructions (#8016)
5375745 is described below
commit 537574519341988338c1dc35bb23cbbf909decf4
Author: Maxime Beauchemin <[email protected]>
AuthorDate: Mon Aug 12 14:01:15 2019 -0700
Improve release instructions (#8016)
---
RELEASING/README.md | 114 ++++++++++++++++++++++++----------------------------
1 file changed, 52 insertions(+), 62 deletions(-)
diff --git a/RELEASING/README.md b/RELEASING/README.md
index 7a2f0aa..db53bcc 100644
--- a/RELEASING/README.md
+++ b/RELEASING/README.md
@@ -16,57 +16,6 @@ KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
-# Apache Releases
-
-To make a fresh tarball of a git reference on apache/incubator-superset
-(push your tag first!)
-
-```bash
-docker build -t make_tarball -f Dockerfile.make_tarball . --build-arg
VERSION=0.33.0rc1
-docker run make_tarball -f Dockerfile.make_tarball --env VERSION=0.33.0rc1
-```
-
-To make a working build given a tarball
-```bash
-# Building a docker from a tarball
-VERSION=0.33.0rc2 && \
-docker build -t apache-superset:$VERSION -f Dockerfile.from_tarball .
--build-arg VERSION=$VERSION
-
-# testing the resulting docker
-docker run -p 5001:8088 apache-superset:0.33.0rc2
-# you should be able to access localhost:5001 on your browser
-# login using admin/admin
-```
-
-## Refresh documentation website
-
-Every once in a while we want to compile the documentation and publish it.
-Here's how to do it.
-
-```bash
-# install doc dependencies
-pip install -r docs/requirements.txt
-
-# build the docs
-python setup.py build_sphinx
-
-# copy html files to temp folder
-cp -r docs/_build/html/ /tmp/tmp_superset_docs/
-
-# clone the docs repo
-cd ~/
-git clone https://git-wip-us.apache.org/repos/asf/incubator-superset-site.git
-
-# copy
-cp -r /tmp/tmp_superset_docs/ ~/incubator-superset-site.git/
-
-# commit and push to `asf-site` branch
-cd ~/incubator-superset-site.git/
-git checkout asf-site
-git add .
-git commit -a -m "New doc version"
-git push origin master
-```
# Apache Releases
@@ -81,20 +30,20 @@ need to be done at every release.
```bash
# Create PGP Key, and use your @apache.org email address
gpg --gen-key
-
+
# Checkout ASF dist repo
svn checkout https://dist.apache.org/repos/dist/dev/incubator/superset/
~/svn/superset_dev
svn checkout
https://dist.apache.org/repos/dist/release/incubator/superset/ ~/svn/superset
cd ~/svn/superset
-
-
+
+
# Add your GPG pub key to KEYS file. Replace "Maxime Beauchemin" with your
name
export FULLNAME="Maxime Beauchemin"
(gpg --list-sigs $FULLNAME && gpg --armor --export $FULLNAME ) >> KEYS
-
-
+
+
# Commit the changes
svn commit -m "Add PGP keys of new Superset committer"
```
@@ -107,7 +56,7 @@ Now let's craft a source release
# Setting a VERSION var will be useful
export VERSION=0.31.0rc18
export RELEASE=apache-superset-incubating-${VERSION}
- export RELEASE_TARBAL=${RELEASE}-source.tar.gz
+ export RELEASE_TARBALL=${RELEASE}-source.tar.gz
# Let's create a git tag
git tag -f ${VERSION}
@@ -122,10 +71,10 @@ Now let's craft a source release
mkdir -p ~/svn/superset_dev/${VERSION}/
git archive \
--format=tar.gz ${VERSION} \
- --prefix=${RELEASE}/ \
+ --prefix="${RELEASE}/" \
-o ~/svn/superset_dev/${VERSION}/${RELEASE_TARBALL}
- cd ~/svn/superset_dev/
+ cd ~/svn/superset_dev/${VERSION}/
scripts/sign.sh ${RELEASE}-source.tar.gz
```
@@ -134,9 +83,6 @@ Now let's craft a source release
Now let's ship this RC into svn's dev folder
```bash
- # cp or mv the files over to the svn repo
- mkdir ~/svn/superset_dev/${VERSION}/
- cp ${RELEASE_TARBALL} ~/svn/superset_dev/${VERSION}/
cd ~/svn/superset_dev/
svn add ${VERSION}
svn commit
@@ -161,3 +107,47 @@ folder.
Now you can announce the release on the mailing list, make sure to use the
proper template
+
+## Build from source tarball
+
+To make a working build given a tarball
+```bash
+# Building a docker from a tarball
+VERSION=0.33.0rc2 && \
+docker build -t apache-superset:$VERSION -f Dockerfile.from_tarball .
--build-arg VERSION=$VERSION
+
+# testing the resulting docker
+docker run -p 5001:8088 apache-superset:$VERSION
+# you should be able to access localhost:5001 on your browser
+# login using admin/admin
+```
+
+# Refresh documentation website
+
+Every once in a while we want to compile the documentation and publish it.
+Here's how to do it.
+
+```bash
+# install doc dependencies
+pip install -r docs/requirements.txt
+
+# build the docs
+python setup.py build_sphinx
+
+# copy html files to temp folder
+cp -r docs/_build/html/ /tmp/tmp_superset_docs/
+
+# clone the docs repo
+cd ~/
+git clone https://git-wip-us.apache.org/repos/asf/incubator-superset-site.git
+
+# copy
+cp -r /tmp/tmp_superset_docs/ ~/incubator-superset-site.git/
+
+# commit and push to `asf-site` branch
+cd ~/incubator-superset-site.git/
+git checkout asf-site
+git add .
+git commit -a -m "New doc version"
+git push origin master
+```
