Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DigitalPebble/storm-crawler
A scalable, mature and versatile web crawler based on Apache Storm
https://github.com/DigitalPebble/storm-crawler
apache-storm crawler distributed java stormcrawler web-crawler
Last synced: 3 months ago
JSON representation
A scalable, mature and versatile web crawler based on Apache Storm
- Host: GitHub
- URL: https://github.com/DigitalPebble/storm-crawler
- Owner: apache
- License: apache-2.0
- Created: 2013-04-12T14:13:30.000Z (over 11 years ago)
- Default Branch: main
- Last Pushed: 2024-05-21T07:16:37.000Z (6 months ago)
- Last Synced: 2024-05-21T07:21:00.931Z (6 months ago)
- Topics: apache-storm, crawler, distributed, java, stormcrawler, web-crawler
- Language: HTML
- Homepage: https://stormcrawler.apache.org/
- Size: 6.58 MB
- Stars: 861
- Watchers: 71
- Forks: 256
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-streaming - storm-crawler - Web crawler SDK based on Apache Storm. (Table of Contents / Streaming Application)
- awesome-streaming - storm-crawler - Web crawler SDK based on Apache Storm. (Table of Contents / Streaming Application)
README
[](http://stormcrawler.net/)
=============
[](http://www.apache.org/licenses/LICENSE-2.0)
[](https://javadoc.io/doc/org.apache.stormcrawler/stormcrawler-core/)
[](https://coveralls.io/github/apache/incubator-stormcrawler?branch=master)
Apache StormCrawler (Incubating) is an open source collection of resources for building low-latency, scalable web crawlers on [Apache Storm](http://storm.apache.org/). It is provided under [Apache License](http://www.apache.org/licenses/LICENSE-2.0) and is written mostly in Java.
## Quickstart
NOTE: These instructions assume that you have [Apache Maven](https://maven.apache.org/install.html) installed. You will need to install [Apache Storm 2.6.2](http://storm.apache.org/) to run the crawler.
StormCrawler requires Java 11 or above. To execute tests, it requires you to have a locally installed and working Docker environment.
DigitalPebble's [Ansible-Storm](https://github.com/DigitalPebble/ansible-storm) repository contains resources to install Apache Storm using Ansible. Alternatively, this [stormcrawler-docker](https://github.com/DigitalPebble/stormcrawler-docker) project should help you run Apache Storm on Docker.
Once Storm is installed, the easiest way to get started is to generate a new StormCrawler project following the instructions below:
```shell
mvn archetype:generate -DarchetypeGroupId=org.apache.stormcrawler -DarchetypeArtifactId=stormcrawler-archetype -DarchetypeVersion=3.0
```
You'll be asked to enter a groupId (e.g. com.mycompany.crawler), an artefactId (e.g. stormcrawler), a version, a package name and details about the user agent to use.
This will not only create a fully formed project containing a POM with the dependency above but also the default resource files, a default CrawlTopology class and a configuration file. Enter the directory you just created (should be the same as the artefactId you specified earlier) and follow the instructions on the README file.
Alternatively if you can't or don't want to use the Maven archetype above, you can simply copy the files from [archetype-resources](https://github.com/apache/incubator-stormcrawler/tree/master/archetype/src/main/resources/archetype-resources).
Have a look at the code of the [CrawlTopology class](https://github.com/apache/incubator-stormcrawler/blob/master/archetype/src/main/resources/archetype-resources/src/main/java/CrawlTopology.java), the [crawler-conf.yaml](https://github.com/apache/incubator-stormcrawler/blob/master/archetype/src/main/resources/archetype-resources/crawler-conf.yaml) file as well as the files in [src/main/resources/](https://github.com/apache/incubator-stormcrawler/tree/master/archetype/src/main/resources/archetype-resources/src/main/resources), they are all that is needed to run a crawl topology : all the other components come from the core module.
## Getting help
The [WIKI](https://github.com/apache/incubator-stormcrawler/wiki) is a good place to start your investigations but if you are stuck please use the tag [stormcrawler](http://stackoverflow.com/questions/tagged/stormcrawler) on StackOverflow or ask a question in the [discussions](https://github.com/apache/incubator-stormcrawler/discussions) section.
The project website has a page listing companies providing [commercial support](https://stormcrawler.apache.org/support/) for Apache StormCrawler.
## Note for developers
Please format your code before submitting a PR with
```
mvn git-code-format:format-code -Dgcf.globPattern="**/*" -Dskip.format.code=false
```
You can enable pre-commit format hooks by running:
```
mvn clean install -Dskip.format.code=false
```
## Thanks
YourKit supports open source projects with its full-featured Java Profiler.
YourKit, LLC is the creator of YourKit Java Profiler
and YourKit .NET Profiler,
innovative and intelligent tools for profiling Java and .NET applications.