[
https://issues.apache.org/jira/browse/BEAM-8787?focusedWorklogId=584518&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-584518
]
ASF GitHub Bot logged work on BEAM-8787:
----------------------------------------
Author: ASF GitHub Bot
Created on: 16/Apr/21 21:13
Start Date: 16/Apr/21 21:13
Worklog Time Spent: 10m
Work Description: tysonjh commented on a change in pull request #14477:
URL: https://github.com/apache/beam/pull/14477#discussion_r615125251
##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -151,15 +187,49 @@ script which is part of the Beam repo:
### Development Setup {#development-setup}
-1. If you need help with git forking, cloning, branching, committing, pull
requests, and squashing commits, see
- [Git workflow
tips](https://cwiki.apache.org/confluence/display/BEAM/Git+Tips)
-1. Clone the git repository. You can download it anywhere you like, however
for Go development we recommend putting it in your
[`$GOPATH`](https://golang.org/doc/gopath_code#GOPATH) (`$HOME/go` by default
on Unix systems).
+1. Check [Git workflow
tips](https://cwiki.apache.org/confluence/display/BEAM/Git+Tips) if you need
help with git forking, cloning, branching, committing, pull requests, and
squashing commits.
+1. Clone the git repository. You can download it anywhere you like.
$ mkdir -p ~/go/src/github.com/apache
$ cd ~/go/src/github.com/apache
$ git clone https://github.com/apache/beam
$ cd beam
+ - For Go development:
+ We recommend putting it in your
[`$GOPATH`](https://golang.org/doc/gopath_code#GOPATH) (`$HOME/go` by default
on Unix systems).
+ 1. Clone the repo, and update your branch as normal
+ $ git clone https://github.com/apache/beam.git
+ $ cd beam
+ $ git remote add <GitHub_user>
[email protected]:<GitHub_user>/beam.git
+ $ git fetch --all
+ 1. Get or Update all the Go SDK dependencies
+ $ go get -u ./...
+
+1. Check the environment was set up correctly.
+ - **Option 1**: validate the Go, Java, and Python environments:
+
+ **Important**: Make sure you have activated Python development.
+```
+./gradlew :checkSetUp
Review comment:
```suggestion
./gradlew :checkSetup
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
Issue Time Tracking
-------------------
Worklog Id: (was: 584518)
Time Spent: 1.5h (was: 1h 20m)
> Python setup issues
> -------------------
>
> Key: BEAM-8787
> URL: https://issues.apache.org/jira/browse/BEAM-8787
> Project: Beam
> Issue Type: Bug
> Components: build-system
> Affects Versions: 2.16.0
> Environment: debian x86 (gLinux)
> Reporter: Elliotte Rusty Harold
> Assignee: Josias Misael Rico Garcia
> Priority: P2
> Time Spent: 1.5h
> Remaining Estimate: 0h
>
> This could be an issue with incomplete or inaccurate contributing docs. tldr;
> `./gradlew check` fails on Debian after initial checkout.
> The docs say that one should first run:
> sudo apt-get install \
> openjdk-8-jdk \
> python-setuptools \
> python-pip \
> virtualenv
> but even after running this pieces are missing. I'm still debugging exactly
> what's missing but the symptoms look like this:
> > Task :sdks:python:test-suites:tox:py35:setupVirtualenv FAILED
> The path python3.5 (from --python=python3.5) does not exist
> > Task :sdks:python:test-suites:tox:py36:setupVirtualenv FAILED
> [ant:fmpp] Traceback (most recent call last):
> [ant:fmpp] File "/usr/lib/python3/dist-packages/virtualenv.py", line 25, in
> <module>
> [ant:fmpp] import distutils.sysconfig
> [ant:fmpp] ModuleNotFoundError: No module named 'distutils.sysconfig'
> ...
> FAILURE: Build completed with 2 failures.
> 1: Task failed with an exception.
> -----------
> * What went wrong:
> Execution failed for task ':sdks:python:test-suites:tox:py35:setupVirtualenv'.
> > Process 'command 'virtualenv'' finished with non-zero exit value 3
> Indeed there is no Python 3.5 on this system:
> gnome-user-share python2.6
> gnome-vfs-2.0 python2.7
> gnupg python3
> gnupg2 python3.6
> gold-ld python3.7
> goobuntu-config-tools python3.8
> But nowhere in the setup docs do we say that Python 3.5 is required to build
> this.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
