cassandra-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject cassandra git commit: Docs: add dependency management page
Date Tue, 25 Jul 2017 13:24:42 GMT
Repository: cassandra
Updated Branches:
  refs/heads/trunk d4bfa5984 -> 1d032e635


Docs: add dependency management page


Project: http://git-wip-us.apache.org/repos/asf/cassandra/repo
Commit: http://git-wip-us.apache.org/repos/asf/cassandra/commit/1d032e63
Tree: http://git-wip-us.apache.org/repos/asf/cassandra/tree/1d032e63
Diff: http://git-wip-us.apache.org/repos/asf/cassandra/diff/1d032e63

Branch: refs/heads/trunk
Commit: 1d032e635965e17e6a365c1e85a41379b4f41e29
Parents: d4bfa59
Author: Stefan Podkowinski <stefan.podkowinski@1und1.de>
Authored: Mon Jul 24 14:29:20 2017 +0200
Committer: Stefan Podkowinski <stefan.podkowinski@1und1.de>
Committed: Tue Jul 25 15:24:16 2017 +0200

----------------------------------------------------------------------
 doc/source/development/dependencies.rst | 54 ++++++++++++++++++++++++++++
 doc/source/development/index.rst        |  1 +
 2 files changed, 55 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cassandra/blob/1d032e63/doc/source/development/dependencies.rst
----------------------------------------------------------------------
diff --git a/doc/source/development/dependencies.rst b/doc/source/development/dependencies.rst
new file mode 100644
index 0000000..7d230d3
--- /dev/null
+++ b/doc/source/development/dependencies.rst
@@ -0,0 +1,54 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements.  See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership.  The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License.  You may obtain a copy of the License at
+..
+..     http://www.apache.org/licenses/LICENSE-2.0
+..
+.. Unless required by applicable law or agreed to in writing, software
+.. distributed under the License is distributed on an "AS IS" BASIS,
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+.. See the License for the specific language governing permissions and
+.. limitations under the License.
+
+Dependency Management
+*********************
+
+Managing libraries for Cassandra is a bit less straight forward compared to other projects,
as the build process is based on ant, maven and manually managed jars. Make sure to follow
the steps below carefully and pay attention to any emerging issues in the :doc:`ci` and reported
related issues on Jira/ML, in case of any project dependency changes.
+
+As Cassandra is an Apache product, all included libraries must follow Apache's `software
license requirements <https://www.apache.org/legal/resolved.html>`_.
+
+Required steps to add or update libraries
+=========================================
+
+* Add or replace jar file in ``lib`` directory
+* Add or update ``lib/license`` files
+* Update dependencies in ``build.xml``
+
+  * Add to ``parent-pom`` with correct version
+  * Add to ``all-pom`` if simple Cassandra dependency (see below)
+
+
+POM file types
+==============
+
+* **parent-pom** - contains all dependencies with the respective version. All other poms
will refer to the artifacts with specified versions listed here.
+* **build-deps-pom(-sources)** + **coverage-deps-pom** - used by ``ant build`` compile target.
Listed dependenices will be resolved and copied to ``build/lib/{jar,sources}`` by executing
the ``maven-ant-tasks-retrieve-build`` target. This should contain libraries that are required
for build tools (grammar, docs, instrumentation), but are not shipped as part of the Cassandra
distribution.
+* **test-deps-pom** - refered by ``maven-ant-tasks-retrieve-test`` to retrieve and save dependencies
to ``build/test/lib``. Exclusively used during JUnit test execution.
+* **all-pom** - pom for `cassandra-all.jar <https://mvnrepository.com/artifact/org.apache.cassandra/cassandra-all>`_
that can be installed or deployed to public maven repos via ``ant publish``
+* **dist-pom** - pom for tarball distribution (cassandra-{bin,src}.tar.gz) created by ``ant
artifacts``. Should be left as is, but needed for installing or deploying releases.
+
+
+Troubleshooting and conflict resolution
+=======================================
+
+Here are some useful commands that may help you out resolving conflicts.
+
+* ``ant realclean`` - gets rid of the build directory, including build artifacts.
+* ``mvn dependency:tree -f build/apache-cassandra-*-SNAPSHOT.pom -Dverbose -Dincludes=org.slf4j``
- shows transitive dependency tree for artifacts, e.g. org.slf4j. In case the command above
fails due to a missing parent pom file, try running ``ant mvn-install``.
+* ``rm ~/.m2/repository/org/apache/cassandra/apache-cassandra/`` - removes cached local Cassandra
maven artifacts
+
+

http://git-wip-us.apache.org/repos/asf/cassandra/blob/1d032e63/doc/source/development/index.rst
----------------------------------------------------------------------
diff --git a/doc/source/development/index.rst b/doc/source/development/index.rst
index 33de8ee..898bbff 100644
--- a/doc/source/development/index.rst
+++ b/doc/source/development/index.rst
@@ -29,3 +29,4 @@ Contributing to Cassandra
    how_to_commit
    documentation
    ci
+   dependencies


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org


Mime
View raw message