-
Notifications
You must be signed in to change notification settings - Fork 199
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: Replace Arrow Ballista with DataFusion Ballista (#1041)
* replace arrow-ballista with datafusion-ballista * update more references to Arrow * fix info on docs publishing * update more references * more updates
- Loading branch information
Showing
13 changed files
with
79 additions
and
129 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -26,55 +26,15 @@ All participation in the Apache DataFusion Ballista project is governed by the | |
Apache Software Foundation's [code of | ||
conduct](https://www.apache.org/foundation/policies/conduct.html). | ||
|
||
## Questions? | ||
We use the same communication channels as the main DataFusion project: | ||
|
||
### Mailing list | ||
|
||
We use datafusion.apache.org's `dev@` mailing list for project management, release | ||
coorindation and design discussions | ||
([subscribe](mailto:[email protected]), | ||
[unsubscribe](mailto:[email protected]), | ||
[archives](https://lists.apache.org/[email protected])). | ||
|
||
When emailing the dev list, please make sure to prefix the subject line with a | ||
`[Ballista]` tag, e.g. `"[Ballista] New API for remote data sources"`, so | ||
that the appropriate people in the Apache DataFusion community notice the message. | ||
|
||
### Slack and Discord | ||
|
||
We use the official [ASF](https://s.apache.org/slack-invite) Slack workspace | ||
for informal discussions and coordination. This is a great place to meet other | ||
contributors and get guidance on where to contribute. Join us in the | ||
`#arrow-rust` channel. | ||
|
||
We also have a backup Arrow Rust Discord | ||
server ([invite link](https://discord.gg/Qw5gKqHxUM)) in case you are not able | ||
to join the Slack workspace. If you need an invite to the Slack workspace, you | ||
can also ask for one in our Discord server. | ||
|
||
### Sync up video calls | ||
|
||
We have biweekly sync calls every other Thursdays at both 04:00 UTC | ||
and 16:00 UTC (starting September 30, 2021) depending on if there are | ||
items on the agenda to discuss and someone being willing to host. | ||
|
||
Please see the [agenda](https://docs.google.com/document/d/1atCVnoff5SR4eM4Lwf2M1BBJTY6g3_HUNR6qswYJW_U/edit) | ||
for the video call link, add topics and to see what others plan to discuss. | ||
|
||
The goals of these calls are: | ||
|
||
1. Help "put a face to the name" of some of other contributors we are working with | ||
2. Discuss / synchronize on the goals and major initiatives from different stakeholders to identify areas where more alignment is needed | ||
|
||
No decisions are made on the call and anything of substance will be discussed on this mailing list or in github issues / google docs. | ||
|
||
We will send a summary of all sync ups to the [email protected] mailing list. | ||
[https://datafusion.apache.org/contributor-guide/communication.html](https://datafusion.apache.org/contributor-guide/communication.html) | ||
|
||
## Contributing | ||
|
||
Our source code is hosted on | ||
[GitHub](https://github.com/apache/arrow-datafusion). More information on contributing is in | ||
the [Contribution Guide](https://github.com/apache/arrow-datafusion/blob/master/CONTRIBUTING.md) | ||
[GitHub](https://github.com/apache/datafusion-ballista). More information on contributing is in | ||
the [Contribution Guide](https://github.com/apache/datafusion-ballista/blob/main/CONTRIBUTING.md) | ||
, and we have curated a [good-first-issue](https://github.com/apache/datafusion-ballista/contribute) | ||
list to help you get started. You can find datafusion's major designs in docs/source/specification. | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -23,31 +23,31 @@ Docker Compose is a convenient way to launch a cluster when testing locally. | |
|
||
## Build Docker Images | ||
|
||
Run the following commands to download the [official Docker image](https://github.com/apache/arrow-ballista/pkgs/container/arrow-ballista-standalone): | ||
Run the following commands to download the [official Docker image](https://github.com/apache/datafusion-ballista/pkgs/container/datafusion-ballista-standalone): | ||
|
||
```bash | ||
docker pull ghcr.io/apache/arrow-ballista-standalone:0.12.0-rc4 | ||
docker pull ghcr.io/apache/datafusion-ballista-standalone:0.12.0-rc4 | ||
``` | ||
|
||
Altenatively run the following commands to clone the source repository and build the Docker images from source: | ||
|
||
```bash | ||
git clone [email protected]:apache/arrow-ballista.git -b 0.12.0 | ||
cd arrow-ballista | ||
git clone [email protected]:apache/datafusion-ballista.git -b 0.12.0 | ||
cd datafusion-ballista | ||
./dev/build-ballista-docker.sh | ||
``` | ||
|
||
This will create the following images: | ||
|
||
- `apache/arrow-ballista-benchmarks:0.12.0` | ||
- `apache/arrow-ballista-cli:0.12.0` | ||
- `apache/arrow-ballista-executor:0.12.0` | ||
- `apache/arrow-ballista-scheduler:0.12.0` | ||
- `apache/arrow-ballista-standalone:0.12.0` | ||
- `apache/datafusion-ballista-benchmarks:0.12.0` | ||
- `apache/datafusion-ballista-cli:0.12.0` | ||
- `apache/datafusion-ballista-executor:0.12.0` | ||
- `apache/datafusion-ballista-scheduler:0.12.0` | ||
- `apache/datafusion-ballista-standalone:0.12.0` | ||
|
||
## Start a Cluster | ||
|
||
Using the [docker-compose.yml](https://github.com/apache/arrow-ballista/blob/main/docker-compose.yml) from the | ||
Using the [docker-compose.yml](https://github.com/apache/datafusion-ballista/blob/main/docker-compose.yml) from the | ||
source repository, run the following command to start a cluster: | ||
|
||
```bash | ||
|
@@ -77,5 +77,5 @@ The scheduler web UI is available on port 80 in the scheduler. | |
## Connect from the Ballista CLI | ||
|
||
```shell | ||
docker run --network=host -it apache/arrow-ballista-cli:0.12.0 --host localhost --port 50050 | ||
docker run --network=host -it apache/datafusion-ballista-cli:0.12.0 --host localhost --port 50050 | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -21,27 +21,27 @@ | |
|
||
## Build Docker Images | ||
|
||
Run the following commands to download the [official Docker image](https://github.com/apache/arrow-ballista/pkgs/container/arrow-ballista-standalone): | ||
Run the following commands to download the [official Docker image](https://github.com/apache/datafusion-ballista/pkgs/container/datafusion-ballista-standalone): | ||
|
||
```bash | ||
docker pull ghcr.io/apache/arrow-ballista-standalone:0.12.0-rc4 | ||
docker pull ghcr.io/apache/datafusion-ballista-standalone:0.12.0-rc4 | ||
``` | ||
|
||
Altenatively run the following commands to clone the source repository and build the Docker images from source: | ||
|
||
```bash | ||
git clone [email protected]:apache/arrow-ballista.git -b 0.12.0 | ||
cd arrow-ballista | ||
git clone [email protected]:apache/datafusion-ballista.git -b 0.12.0 | ||
cd datafusion-ballista | ||
./dev/build-ballista-docker.sh | ||
``` | ||
|
||
This will create the following images: | ||
|
||
- `apache/arrow-ballista-benchmarks:0.12.0` | ||
- `apache/arrow-ballista-cli:0.12.0` | ||
- `apache/arrow-ballista-executor:0.12.0` | ||
- `apache/arrow-ballista-scheduler:0.12.0` | ||
- `apache/arrow-ballista-standalone:0.12.0` | ||
- `apache/datafusion-ballista-benchmarks:0.12.0` | ||
- `apache/datafusion-ballista-cli:0.12.0` | ||
- `apache/datafusion-ballista-executor:0.12.0` | ||
- `apache/datafusion-ballista-scheduler:0.12.0` | ||
- `apache/datafusion-ballista-standalone:0.12.0` | ||
|
||
## Start a Cluster | ||
|
||
|
@@ -51,7 +51,7 @@ Start a scheduler using the following syntax: | |
|
||
```bash | ||
docker run --network=host \ | ||
-d apache/arrow-ballista-scheduler:0.12.0 \ | ||
-d apache/datafusion-ballista-scheduler:0.12.0 \ | ||
--bind-port 50050 | ||
``` | ||
|
||
|
@@ -60,7 +60,7 @@ Run `docker ps` to check that the process is running: | |
``` | ||
$ docker ps | ||
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES | ||
a756055576f3 apache/arrow-ballista-scheduler:0.12.0 "/root/scheduler-ent…" 8 seconds ago Up 8 seconds xenodochial_carson | ||
a756055576f3 apache/datafusion-ballista-scheduler:0.12.0 "/root/scheduler-ent…" 8 seconds ago Up 8 seconds xenodochial_carson | ||
``` | ||
|
||
Run `docker logs CONTAINER_ID` to check the output from the process: | ||
|
@@ -84,7 +84,7 @@ Start one or more executor processes. Each executor process will need to listen | |
|
||
```bash | ||
docker run --network=host \ | ||
-d apache/arrow-ballista-executor:0.12.0 \ | ||
-d apache/datafusion-ballista-executor:0.12.0 \ | ||
--external-host localhost --bind-port 50051 | ||
``` | ||
|
||
|
@@ -93,8 +93,8 @@ Use `docker ps` to check that both the scheduler and executor(s) are now running | |
``` | ||
$ docker ps | ||
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES | ||
fb8b530cee6d apache/arrow-ballista-executor:0.12.0 "/root/executor-entr…" 2 seconds ago Up 1 second gallant_galois | ||
a756055576f3 apache/arrow-ballista-scheduler:0.12.0 "/root/scheduler-ent…" 8 seconds ago Up 8 seconds xenodochial_carson | ||
fb8b530cee6d apache/datafusion-ballista-executor:0.12.0 "/root/executor-entr…" 2 seconds ago Up 1 second gallant_galois | ||
a756055576f3 apache/datafusion-ballista-scheduler:0.12.0 "/root/scheduler-ent…" 8 seconds ago Up 8 seconds xenodochial_carson | ||
``` | ||
|
||
Use `docker logs CONTAINER_ID` to check the output from the executor(s): | ||
|
@@ -117,7 +117,7 @@ to launch the scheduler with this option enabled. | |
|
||
```bash | ||
docker run --network=host \ | ||
-d apache/arrow-ballista-scheduler:0.12.0 \ | ||
-d apache/datafusion-ballista-scheduler:0.12.0 \ | ||
--bind-port 50050 \ | ||
--config-backend etcd \ | ||
--etcd-urls etcd:2379 | ||
|
@@ -129,5 +129,5 @@ recommended. | |
## Connect from the CLI | ||
|
||
```shell | ||
docker run --network=host -it apache/arrow-ballista-cli:0.12.0 --host localhost --port 50050 | ||
docker run --network=host -it apache/datafusion-ballista-cli:0.12.0 --host localhost --port 50050 | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -41,37 +41,37 @@ microk8s enable dns | |
|
||
## Build Docker Images | ||
|
||
Run the following commands to download the [official Docker image](https://github.com/apache/arrow-ballista/pkgs/container/arrow-ballista-standalone): | ||
Run the following commands to download the [official Docker image](https://github.com/apache/datafusion-ballista/pkgs/container/datafusion-ballista-standalone): | ||
|
||
```bash | ||
docker pull ghcr.io/apache/arrow-ballista-standalone:0.12.0-rc4 | ||
docker pull ghcr.io/apache/datafusion-ballista-standalone:0.12.0-rc4 | ||
``` | ||
|
||
Altenatively run the following commands to clone the source repository and build the Docker images from source: | ||
|
||
```bash | ||
git clone [email protected]:apache/arrow-ballista.git -b 0.12.0 | ||
cd arrow-ballista | ||
git clone [email protected]:apache/datafusion-ballista.git -b 0.12.0 | ||
cd datafusion-ballista | ||
./dev/build-ballista-docker.sh | ||
``` | ||
|
||
This will create the following images: | ||
|
||
- `apache/arrow-ballista-benchmarks:0.12.0` | ||
- `apache/arrow-ballista-cli:0.12.0` | ||
- `apache/arrow-ballista-executor:0.12.0` | ||
- `apache/arrow-ballista-scheduler:0.12.0` | ||
- `apache/arrow-ballista-standalone:0.12.0` | ||
- `apache/datafusion-ballista-benchmarks:0.12.0` | ||
- `apache/datafusion-ballista-cli:0.12.0` | ||
- `apache/datafusion-ballista-executor:0.12.0` | ||
- `apache/datafusion-ballista-scheduler:0.12.0` | ||
- `apache/datafusion-ballista-standalone:0.12.0` | ||
|
||
## Publishing Docker Images | ||
|
||
Once the images have been built, you can retag them and can push them to your favourite Docker registry. | ||
|
||
```bash | ||
docker tag apache/arrow-ballista-scheduler:0.12.0 <your-repo>/arrow-ballista-scheduler:0.12.0 | ||
docker tag apache/arrow-ballista-executor:0.12.0 <your-repo>/arrow-ballista-executor:0.12.0 | ||
docker push <your-repo>/arrow-ballista-scheduler:0.12.0 | ||
docker push <your-repo>/arrow-ballista-executor:0.12.0 | ||
docker tag apache/datafusion-ballista-scheduler:0.12.0 <your-repo>/datafusion-ballista-scheduler:0.12.0 | ||
docker tag apache/datafusion-ballista-executor:0.12.0 <your-repo>/datafusion-ballista-executor:0.12.0 | ||
docker push <your-repo>/datafusion-ballista-scheduler:0.12.0 | ||
docker push <your-repo>/datafusion-ballista-executor:0.12.0 | ||
``` | ||
|
||
## Create Persistent Volume and Persistent Volume Claim | ||
|
@@ -159,7 +159,7 @@ spec: | |
spec: | ||
containers: | ||
- name: ballista-scheduler | ||
image: <your-repo>/arrow-ballista-scheduler:0.12.0 | ||
image: <your-repo>/datafusion-ballista-scheduler:0.12.0 | ||
args: ["--bind-port=50050"] | ||
ports: | ||
- containerPort: 50050 | ||
|
@@ -191,7 +191,7 @@ spec: | |
spec: | ||
containers: | ||
- name: ballista-executor | ||
image: <your-repo>/arrow-ballista-executor:0.12.0 | ||
image: <your-repo>/datafusion-ballista-executor:0.12.0 | ||
args: | ||
- "--bind-port=50051" | ||
- "--scheduler-host=ballista-scheduler" | ||
|
Oops, something went wrong.