Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

The CGCloud Spark project lets you setup a functioning Apache Spark cluster in EC2 in just minutes, regardless of the number of nodes. It is a plugin to CGCloud. While Apache Spark already comes with a script called spark-ec2 that lets you build a cluster in EC2, CGCloud Spark differs from spark-ec2 in the following ways (bad news first):

  • Tachyon and Yarn are not yet supported.

  • Setup time does not scale linearly with the number of nodes. Setting up a 100 node cluster takes just as long as setting up a 10 node cluster (2-3 min, as opposed to 45min with spark-ec2). This is made possible by baking all required software into a single AMI. All slave nodes boot up concurrently and autonomously in just a few minutes.

  • Unlike with spark-ec2, the cluster can be stopped and started via the EC2 API or the EC2 console, without involvement of cgcloud.

  • The Spark services (master and worker) run as an unprivileged user, not root as with spark-ec2. Ditto for the HDFS services (namenode, datanode and secondarynamenode).

  • The Spark and Hadoop services are started automatically as the instance boots up, via a regular init script.

  • Nodes can be added easily, simply by booting up new instances from the AMI. They will join the cluster automatically. HDFS may have to be rebalanced after that.

  • You can customize the AMI that cluster nodes boot from by subclassing the SparkMaster and SparkSlave classes.

  • CGCloud Spark uses the CGCLoud Agent which takes care of maintaining a list of authorized keypairs on each node.

  • CGCloud Spark is based on the official Ubuntu Trusty 14.04 LTS, not the Amazon Linux AMI.

Prerequisites

The cgcloud-spark package requires that the cgcloud-core package and its prerequisites are present.

Installation

Read the entire section before pasting any commands and ensure that all prerequisites are installed. It is recommended to install cgcloud into a virtualenv. Create a virtualenv and use pip to install cgcloud-spark:

virtualenv cgcloud
source cgcloud/bin/activate
pip install cgcloud-spark

On OS X systems with a Python that was installed via HomeBrew, you should omit sudo. You can find out if that applies to your system by running which python. If it prints /usr/local/bin/python you are most likely using a HomeBrew Python and should therefore omit sudo. If it prints /usr/bin/python you need to run pip with sudo.

Be sure to configure cgcloud-core before proceeding.

Configuration

Modify your .profile or .bash_profile by adding the following line:

export CGCLOUD_PLUGINS=cgcloud.spark

Login and out (or, on OS X, start a new Terminal tab/window).

Verify the installation by running:

cgcloud list-roles

The output should include the spark-box role.

Usage

Create a single t2.micro box to serve as the template for the cluster nodes:

cgcloud create spark-box -I -T

The -I switch stops the box once it is fully set up and takes an AMI of it. The -T switch terminates it after that.

Create a cluster by booting a master and the slaves from that AMI:

cgcloud create-spark-cluster -s 2 -t m3.large

This will launch a master and two slaves using the m3.large instance type.

SSH into the master:

cgcloud ssh spark-master

… or the first slave:

cgcloud ssh spark-slave -o 0

… or the second slave:

cgcloud ssh spark-slave -o 1

Interactions with Spark and HDFS should be done as the sparkbox user:

cgcloud ssh spark-master -l sparkbox
hdfs dfs -ls /
spark-shell

Otherwise you are likely to run into permission problems.

Metadata

Release files for cgcloud-spark 1.1a1.dev130

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cgcloud-spark 1.1a1.dev130
File Size Uploaded Provenance
cgcloud-spark-1.1a1.dev130.tar.gz 11.7 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for cgcloud-spark 1.1a1.dev130
File Interpreter ABI Platform
cgcloud_spark-1.1a1.dev130-py2.7.egg Legacy Egg format - - Details

Total release size: 37.3 kB

Release files / cgcloud-spark-1.1a1.dev130.tar.gz

Download URL cgcloud-spark-1.1a1.dev130.tar.gz
Size 11.7 kB
Tags Source
SHA-256 checksum
How to use checksums
f6222a6f670a78f19f5af0d5c52dde57380d7b9d370a4f6c1317e1845b3bcade
BLAKE2b-256 checksum
How to use checksums
f401a10b81caf0b383fd47b4210473851c3ad320a6d36af94837d72cc55b7c3f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / cgcloud_spark-1.1a1.dev130-py2.7.egg

Download URL cgcloud_spark-1.1a1.dev130-py2.7.egg
Size 25.7 kB
Tags Egg
SHA-256 checksum
How to use checksums
6a787fe8cc2d43921d137a506326b7023e9efec36374366942d8da02019f566c
BLAKE2b-256 checksum
How to use checksums
f35aa2471ce329d3cf785d7e3dbd17c4e89b795639abd80596f7b89ce20a92c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for cgcloud-spark 1.1a1.dev130

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page