Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

README improvements & fixes #283

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

juhoautio
Copy link

What changes were proposed in this pull request?

  • Fix jar name to be that of the uber jar
  • Document how to obtain atlas-application.properties
  • Add instructions for rest client
  • Clarify the difference in conf between spark deploy modes

How was this patch tested?

Manual tests against Atlas 1.0.0 with SAC uber jar built from current master.

Tested both cases:

  1. --deploy-mode cluster + --files s3://my-bucket/atlas-application.properties
  2. without those

- Fix jar name to be that of the uber jar
- Document how to obtain `atlas-application.properties`
- Add instructions for rest client
- Clarify the difference in conf between spark deploy modes
To use it, you will need to make this jar accessible in Spark Driver, also configure
The connector itself is configured with `atlas-application.properties`.

To get started, you can copy the `atlas-application.properties` from your Atlas server.
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't know though – is this the recommended way?

If your Atlas server is not on the same host as where your spark job is run:
- Replace `atlas.rest.address=http://localhost:21000` with `http://your-atlas-host:21000`

For production use, consider using `atlas.client.type=kafka` instead.
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For me kafka didn't work out of box. Maybe I would've had to modify some other properties to set the host names right. Any way, rest should work in all configurations and can be handy when people want to quickly try out this connector.


```shell
bin/spark-shell --jars spark-atlas-connector_2.11-0.1.0-SNAPSHOT.jar \
bin/spark-shell --jars spark-atlas-connector-assembly-0.1.0-SNAPSHOT.jar \
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here fixing to use the name of the uberjar. Isn't it generally the jar to be used?

@@ -25,7 +25,11 @@ To build this project, please execute:
mvn package -DskipTests
```

`mvn package` will assemble all the required dependencies and package into an uber jar.
`mvn package` will assemble all the required dependencies and package into an uber jar:
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this connector supposed to be always built from source, or are ready-made uber jar downloads available somewhere?

@juhoautio
Copy link
Author

One more thing: the README doesn't mention any place for discussing SAC, asking questions etc. Is there some mailing list, gitter room or such? Or can github issues be used?

@juhoautio
Copy link
Author

@HeartSaVioR would you have any comments, please? This repo doesn't seem too active though, is this still maintained?

@shivsood
Copy link

Reiterating @juhoautio comment. Repo does not seem very active. Is this maintained any longer?
Was thinking of using the connector for some evalatution. Not very clear what state is this in as of now.

@ajs6f
Copy link

ajs6f commented Jul 21, 2020

I don't think this project is supported any more (#304). It would have been nice if Cloudera had announced that instead of just walking away silently.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants