You are viewing a plain text version of this content. The canonical link for it is here.
Posted to github@arrow.apache.org by GitBox <gi...@apache.org> on 2022/03/07 17:41:21 UTC

[GitHub] [arrow] davisusanibar opened a new pull request #12578: Arrow 15864: [JAVA][DOC] Update Arrow nightly Maven releases documentation

davisusanibar opened a new pull request #12578:
URL: https://github.com/apache/arrow/pull/12578


   Current java artifacts nightly build are uploaded to github as an assets.
   
   Update current [documentation|https://github.com/apache/arrow/blob/650f111b524fb1c5bfbfa6f533d15929c90ddc40/docs/source/java/install.rst#installing-nightly-packages related to how to install java artifacts nightly 
   
   The artifacts are downloaded without problems but .pom and .jar are downloaded as an invalid file format.
   
   Add detail about how to upload jar to maven locally.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] lidavidm commented on a change in pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
lidavidm commented on a change in pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#discussion_r822104020



##########
File path: docs/source/java/install.rst
##########
@@ -81,39 +81,86 @@ Installing Nightly Packages
 .. warning::
     These packages are not official releases. Use them at your own risk.
 
-Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
+Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+The artifacts are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Maven cannot directly use the artifacts from GitHub.
+Instead, install them to the local Maven repository:
 
-.. code-block:: xml
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`
 
-    $ cat ~/.m2/settings.xml
-    <?xml version="1.0" encoding="UTF-8"?>
-    <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <profiles>
-        <profile>
-          <repositories>
-            <repository>
-               <id>staged</id>
-               <name>staged-releases</name>
-               <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
-               <releases>
-                 <enabled>true</enabled>
-               </releases>
-               <snapshots>
-                 <enabled>true</enabled>
-               </snapshots>
-             </repository>
-          </repositories>
-          <id>arrownightly</id>
-        </profile>
-      </profiles>
-    </settings>
-    $ mvn -Parrownightly clean install -X
-    Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+.. code-block:: xml
 
-Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <arrow.version>8.0.0.dev165</arrow.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-vector</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-format</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+    </dependencies>
+
+3. Download packages needed to a temporary directory

Review comment:
       ```suggestion
   3. Download packages needed to a temporary directory:
   ```

##########
File path: docs/source/java/install.rst
##########
@@ -81,39 +81,86 @@ Installing Nightly Packages
 .. warning::
     These packages are not official releases. Use them at your own risk.
 
-Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
+Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+The artifacts are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Maven cannot directly use the artifacts from GitHub.
+Instead, install them to the local Maven repository:
 
-.. code-block:: xml
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`

Review comment:
       ```suggestion
   2. Add packages to your pom.xml, for example: ``arrow-vector`` and ``arrow-format``:
   ```

##########
File path: docs/source/java/install.rst
##########
@@ -81,39 +81,86 @@ Installing Nightly Packages
 .. warning::
     These packages are not official releases. Use them at your own risk.
 
-Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
+Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+The artifacts are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Maven cannot directly use the artifacts from GitHub.
+Instead, install them to the local Maven repository:
 
-.. code-block:: xml
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`
 
-    $ cat ~/.m2/settings.xml
-    <?xml version="1.0" encoding="UTF-8"?>
-    <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <profiles>
-        <profile>
-          <repositories>
-            <repository>
-               <id>staged</id>
-               <name>staged-releases</name>
-               <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
-               <releases>
-                 <enabled>true</enabled>
-               </releases>
-               <snapshots>
-                 <enabled>true</enabled>
-               </snapshots>
-             </repository>
-          </repositories>
-          <id>arrownightly</id>
-        </profile>
-      </profiles>
-    </settings>
-    $ mvn -Parrownightly clean install -X
-    Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+.. code-block:: xml
 
-Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <arrow.version>8.0.0.dev165</arrow.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-vector</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-format</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+    </dependencies>
+
+3. Download packages needed to a temporary directory
+
+.. code-block:: shell
+
+    $ mkdir nightly-2022-03-03-0-github-java-jars
+    $ cd nightly-2022-03-03-0-github-java-jars
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar
+    $ tree
+    |__ arrow-format-8.0.0.dev165.jar
+    |__ arrow-vector-8.0.0.dev165.jar
+
+4. Install the artifacts to the local Maven repository with ``mvn install:install-file``

Review comment:
       ```suggestion
   4. Install the artifacts to the local Maven repository with ``mvn install:install-file``:
   ```




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] ursabot edited a comment on pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
ursabot edited a comment on pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#issuecomment-1062960446


   Benchmark runs are scheduled for baseline = e8a1e1328f3c1bc6bf5ff7ba86057af3e37b634d and contender = a76794c1a3811a698130f95cf72dcbd6cc372a08. a76794c1a3811a698130f95cf72dcbd6cc372a08 is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
   Conbench compare runs links:
   [Finished :arrow_down:0.0% :arrow_up:0.0%] [ec2-t3-xlarge-us-east-2](https://conbench.ursa.dev/compare/runs/c001e11a003f466185fbb027138942fe...13214498df994262a0e689f0f8fc3b45/)
   [Finished :arrow_down:0.21% :arrow_up:0.0%] [test-mac-arm](https://conbench.ursa.dev/compare/runs/a644e510d5804d8bac84a19205cd0446...a0d3df74507a43269cb09e72336e9a20/)
   [Finished :arrow_down:0.0% :arrow_up:0.0%] [ursa-i9-9960x](https://conbench.ursa.dev/compare/runs/e81aa9271a134e7a8d19c35371079837...b685392d45b5478783c9727ec6b10907/)
   [Finished :arrow_down:0.26% :arrow_up:0.0%] [ursa-thinkcentre-m75q](https://conbench.ursa.dev/compare/runs/34a949ee67e247c9813e904c2b0cd8e2...4818dda29cdf482b890c481a14aaa0ea/)
   Supported benchmarks:
   ec2-t3-xlarge-us-east-2: Supported benchmark langs: Python. Runs only benchmarks with cloud = True
   test-mac-arm: Supported benchmark langs: C++, Python, R
   ursa-i9-9960x: Supported benchmark langs: Python, R, JavaScript
   ursa-thinkcentre-m75q: Supported benchmark langs: C++, Java
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] ursabot edited a comment on pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
ursabot edited a comment on pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#issuecomment-1062960446


   Benchmark runs are scheduled for baseline = e8a1e1328f3c1bc6bf5ff7ba86057af3e37b634d and contender = a76794c1a3811a698130f95cf72dcbd6cc372a08. a76794c1a3811a698130f95cf72dcbd6cc372a08 is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
   Conbench compare runs links:
   [Finished :arrow_down:0.0% :arrow_up:0.0%] [ec2-t3-xlarge-us-east-2](https://conbench.ursa.dev/compare/runs/c001e11a003f466185fbb027138942fe...13214498df994262a0e689f0f8fc3b45/)
   [Scheduled] [test-mac-arm](https://conbench.ursa.dev/compare/runs/a644e510d5804d8bac84a19205cd0446...a0d3df74507a43269cb09e72336e9a20/)
   [Scheduled] [ursa-i9-9960x](https://conbench.ursa.dev/compare/runs/e81aa9271a134e7a8d19c35371079837...b685392d45b5478783c9727ec6b10907/)
   [Finished :arrow_down:0.26% :arrow_up:0.0%] [ursa-thinkcentre-m75q](https://conbench.ursa.dev/compare/runs/34a949ee67e247c9813e904c2b0cd8e2...4818dda29cdf482b890c481a14aaa0ea/)
   Supported benchmarks:
   ec2-t3-xlarge-us-east-2: Supported benchmark langs: Python. Runs only benchmarks with cloud = True
   test-mac-arm: Supported benchmark langs: C++, Python, R
   ursa-i9-9960x: Supported benchmark langs: Python, R, JavaScript
   ursa-thinkcentre-m75q: Supported benchmark langs: C++, Java
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] github-actions[bot] commented on pull request #12578: Arrow 15864: [JAVA][DOC] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
github-actions[bot] commented on pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#issuecomment-1060952160


   <!--
     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.
   -->
   
   Thanks for opening a pull request!
   
   If this is not a [minor PR](https://github.com/apache/arrow/blob/master/CONTRIBUTING.md#Minor-Fixes). Could you open an issue for this pull request on JIRA? https://issues.apache.org/jira/browse/ARROW
   
   Opening JIRAs ahead of time contributes to the [Openness](http://theapacheway.com/open/#:~:text=Openness%20allows%20new%20users%20the,must%20happen%20in%20the%20open.) of the Apache Arrow project.
   
   Then could you also rename pull request title in the following format?
   
       ARROW-${JIRA_ID}: [${COMPONENT}] ${SUMMARY}
   
   or
   
       MINOR: [${COMPONENT}] ${SUMMARY}
   
   See also:
   
     * [Other pull requests](https://github.com/apache/arrow/pulls/)
     * [Contribution Guidelines - How to contribute patches](https://arrow.apache.org/docs/developers/contributing.html#how-to-contribute-patches)
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] lidavidm commented on pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
lidavidm commented on pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#issuecomment-1062252073


   +1, will merge after CI


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] lidavidm commented on a change in pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
lidavidm commented on a change in pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#discussion_r822003685



##########
File path: docs/source/java/install.rst
##########
@@ -81,39 +81,91 @@ Installing Nightly Packages
 .. warning::
     These packages are not official releases. Use them at your own risk.
 
-Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
+Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+The artifacts are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Maven cannot directly use the artifacts from GitHub.
+Instead, install them to the local Maven repository:
 
-.. code-block:: xml
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`
 
-    $ cat ~/.m2/settings.xml
-    <?xml version="1.0" encoding="UTF-8"?>
-    <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <profiles>
-        <profile>
-          <repositories>
-            <repository>
-               <id>staged</id>
-               <name>staged-releases</name>
-               <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
-               <releases>
-                 <enabled>true</enabled>
-               </releases>
-               <snapshots>
-                 <enabled>true</enabled>
-               </snapshots>
-             </repository>
-          </repositories>
-          <id>arrownightly</id>
-        </profile>
-      </profiles>
-    </settings>
-    $ mvn -Parrownightly clean install -X
-    Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+.. code-block:: xml
 
-Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <arrow.version>8.0.0.dev165</arrow.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-vector</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-format</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+    </dependencies>
+
+3. Download packages needed to a temporary directory
+
+.. code-block:: shell
+
+    $ mkdir nightly-2022-03-03-0-github-java-jars
+    $ cd nightly-2022-03-03-0-github-java-jars
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar
+    $ tree
+    |__ arrow-format-8.0.0.dev165.jar
+    |__ arrow-vector-8.0.0.dev165.jar
+
+4. Install the artifacts to the local Maven repository with ``mvn install:install-file``
+
+.. code-block:: shell
+
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-format-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-format \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-format/8.0.0.dev165/arrow-format-8.0.0.dev165.jar
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-vector-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-vector \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-vector/8.0.0.dev165/arrow-vector-8.0.0.dev165.jar
+
+6. Validate that the packages were installed:
+
+.. code-block:: shell
+
+    $ tree /Users/arrow/.m2/repository/org/apache/arrow
+    |__ arrow-format
+        |__ 8.0.0.dev165
+            |__ arrow-format-8.0.0.dev165.jar
+            |__ arrow-format-8.0.0.dev165.pom
+    |__ arrow-vector
+        |__ 8.0.0.dev165
+            |__ arrow-vector-8.0.0.dev165.jar
+            |__ arrow-vector-8.0.0.dev165.pom
+
+5. Compile your project with `mvn clean install`.
+
+.. code-block:: shell
+
+    $ mvn clean install
+    [INFO] BUILD SUCCESS

Review comment:
       I don't think we need to show this, just say something like 
   
   ```
   Compile your project like usual with ``mvn install``.
   ```

##########
File path: docs/source/java/install.rst
##########
@@ -81,39 +81,91 @@ Installing Nightly Packages
 .. warning::
     These packages are not official releases. Use them at your own risk.
 
-Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
+Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+The artifacts are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Maven cannot directly use the artifacts from GitHub.
+Instead, install them to the local Maven repository:
 
-.. code-block:: xml
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`
 
-    $ cat ~/.m2/settings.xml
-    <?xml version="1.0" encoding="UTF-8"?>
-    <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <profiles>
-        <profile>
-          <repositories>
-            <repository>
-               <id>staged</id>
-               <name>staged-releases</name>
-               <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
-               <releases>
-                 <enabled>true</enabled>
-               </releases>
-               <snapshots>
-                 <enabled>true</enabled>
-               </snapshots>
-             </repository>
-          </repositories>
-          <id>arrownightly</id>
-        </profile>
-      </profiles>
-    </settings>
-    $ mvn -Parrownightly clean install -X
-    Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+.. code-block:: xml
 
-Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <arrow.version>8.0.0.dev165</arrow.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-vector</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-format</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+    </dependencies>
+
+3. Download packages needed to a temporary directory
+
+.. code-block:: shell
+
+    $ mkdir nightly-2022-03-03-0-github-java-jars
+    $ cd nightly-2022-03-03-0-github-java-jars
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar
+    $ tree
+    |__ arrow-format-8.0.0.dev165.jar
+    |__ arrow-vector-8.0.0.dev165.jar
+
+4. Install the artifacts to the local Maven repository with ``mvn install:install-file``
+
+.. code-block:: shell
+
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-format-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-format \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-format/8.0.0.dev165/arrow-format-8.0.0.dev165.jar
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-vector-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-vector \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-vector/8.0.0.dev165/arrow-vector-8.0.0.dev165.jar
+
+6. Validate that the packages were installed:

Review comment:
       The numbering is off (it goes 6 then 5)




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] github-actions[bot] commented on pull request #12578: ARROW-15864: [JAVA][DOC] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
github-actions[bot] commented on pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#issuecomment-1060952736






-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] davisusanibar commented on a change in pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
davisusanibar commented on a change in pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#discussion_r821777219



##########
File path: docs/source/java/install.rst
##########
@@ -83,35 +83,87 @@ Installing Nightly Packages
 
 Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Follow the steps and get your nightly packages installed to local maven repository:
+
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`
 
 .. code-block:: xml
 
-    $ cat ~/.m2/settings.xml
-    <?xml version="1.0" encoding="UTF-8"?>
-    <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <profiles>
-        <profile>
-          <repositories>
-            <repository>
-               <id>staged</id>
-               <name>staged-releases</name>
-               <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
-               <releases>
-                 <enabled>true</enabled>
-               </releases>
-               <snapshots>
-                 <enabled>true</enabled>
-               </snapshots>
-             </repository>
-          </repositories>
-          <id>arrownightly</id>
-        </profile>
-      </profiles>
-    </settings>
-    $ mvn -Parrownightly clean install -X
-    Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <arrow.version>8.0.0.dev165</arrow.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-vector</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-format</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+    </dependencies>
+
+3. Download packages needed to a temporary directory
+
+.. code-block:: shell
+
+    $ mkdir nightly-2022-03-03-0-github-java-jars
+    $ cd nightly-2022-03-03-0-github-java-jars
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar
+    $ tree
+    |__ arrow-format-8.0.0.dev165.jar
+    |__ arrow-vector-8.0.0.dev165.jar
+
+4. Install nightly java version to local maven repository with `mvn install:install-file`
+
+.. code-block:: shell
+
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-format-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-format \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-format/8.0.0.dev165/arrow-format-8.0.0.dev165.jar
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-vector-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-vector \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-vector/8.0.0.dev165/arrow-vector-8.0.0.dev165.jar
+
+6. Validate packages installed locally on maven repository:
+
+.. code-block:: shell
+
+    $ tree /Users/arrow/.m2/repository/org/apache/arrow
+    |__ arrow-format
+        |__ 8.0.0.dev165
+            |__ arrow-format-8.0.0.dev165.jar
+            |__ arrow-format-8.0.0.dev165.pom
+    |__ arrow-vector
+        |__ 8.0.0.dev165
+            |__ arrow-vector-8.0.0.dev165.jar
+            |__ arrow-vector-8.0.0.dev165.pom
+
+5. Compile your project with `mvn clean install`.
+
+.. code-block:: shell
+
+    $ mvn clean install
+    [INFO] BUILD SUCCESS
 
 Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.

Review comment:
       Added to the initial part of: Installing Nightly Packages




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] lidavidm commented on a change in pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
lidavidm commented on a change in pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#discussion_r821641369



##########
File path: docs/source/java/install.rst
##########
@@ -83,35 +83,87 @@ Installing Nightly Packages
 
 Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Follow the steps and get your nightly packages installed to local maven repository:

Review comment:
       ```suggestion
   Maven cannot directly use the artifacts from GitHub.
   Instead, install them to the local Maven repository:
   ```

##########
File path: docs/source/java/install.rst
##########
@@ -83,35 +83,87 @@ Installing Nightly Packages
 
 Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Follow the steps and get your nightly packages installed to local maven repository:
+
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`
 
 .. code-block:: xml
 
-    $ cat ~/.m2/settings.xml
-    <?xml version="1.0" encoding="UTF-8"?>
-    <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <profiles>
-        <profile>
-          <repositories>
-            <repository>
-               <id>staged</id>
-               <name>staged-releases</name>
-               <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
-               <releases>
-                 <enabled>true</enabled>
-               </releases>
-               <snapshots>
-                 <enabled>true</enabled>
-               </snapshots>
-             </repository>
-          </repositories>
-          <id>arrownightly</id>
-        </profile>
-      </profiles>
-    </settings>
-    $ mvn -Parrownightly clean install -X
-    Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <arrow.version>8.0.0.dev165</arrow.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-vector</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-format</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+    </dependencies>
+
+3. Download packages needed to a temporary directory
+
+.. code-block:: shell
+
+    $ mkdir nightly-2022-03-03-0-github-java-jars
+    $ cd nightly-2022-03-03-0-github-java-jars
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar
+    $ tree
+    |__ arrow-format-8.0.0.dev165.jar
+    |__ arrow-vector-8.0.0.dev165.jar
+
+4. Install nightly java version to local maven repository with `mvn install:install-file`
+
+.. code-block:: shell
+
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-format-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-format \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-format/8.0.0.dev165/arrow-format-8.0.0.dev165.jar
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-vector-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-vector \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-vector/8.0.0.dev165/arrow-vector-8.0.0.dev165.jar
+
+6. Validate packages installed locally on maven repository:

Review comment:
       ```suggestion
   6. Validate that the packages were installed:
   ```

##########
File path: docs/source/java/install.rst
##########
@@ -83,35 +83,87 @@ Installing Nightly Packages
 
 Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Follow the steps and get your nightly packages installed to local maven repository:
+
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`
 
 .. code-block:: xml
 
-    $ cat ~/.m2/settings.xml
-    <?xml version="1.0" encoding="UTF-8"?>
-    <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <profiles>
-        <profile>
-          <repositories>
-            <repository>
-               <id>staged</id>
-               <name>staged-releases</name>
-               <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
-               <releases>
-                 <enabled>true</enabled>
-               </releases>
-               <snapshots>
-                 <enabled>true</enabled>
-               </snapshots>
-             </repository>
-          </repositories>
-          <id>arrownightly</id>
-        </profile>
-      </profiles>
-    </settings>
-    $ mvn -Parrownightly clean install -X
-    Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <arrow.version>8.0.0.dev165</arrow.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-vector</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-format</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+    </dependencies>
+
+3. Download packages needed to a temporary directory
+
+.. code-block:: shell
+
+    $ mkdir nightly-2022-03-03-0-github-java-jars
+    $ cd nightly-2022-03-03-0-github-java-jars
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar
+    $ tree
+    |__ arrow-format-8.0.0.dev165.jar
+    |__ arrow-vector-8.0.0.dev165.jar
+
+4. Install nightly java version to local maven repository with `mvn install:install-file`

Review comment:
       ```suggestion
   4. Install the artifacts to the local Maven repository with ``mvn install:install-file``
   ```

##########
File path: docs/source/java/install.rst
##########
@@ -83,35 +83,87 @@ Installing Nightly Packages
 
 Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Follow the steps and get your nightly packages installed to local maven repository:
+
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`
 
 .. code-block:: xml
 
-    $ cat ~/.m2/settings.xml
-    <?xml version="1.0" encoding="UTF-8"?>
-    <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <profiles>
-        <profile>
-          <repositories>
-            <repository>
-               <id>staged</id>
-               <name>staged-releases</name>
-               <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
-               <releases>
-                 <enabled>true</enabled>
-               </releases>
-               <snapshots>
-                 <enabled>true</enabled>
-               </snapshots>
-             </repository>
-          </repositories>
-          <id>arrownightly</id>
-        </profile>
-      </profiles>
-    </settings>
-    $ mvn -Parrownightly clean install -X
-    Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <arrow.version>8.0.0.dev165</arrow.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-vector</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-format</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+    </dependencies>
+
+3. Download packages needed to a temporary directory
+
+.. code-block:: shell
+
+    $ mkdir nightly-2022-03-03-0-github-java-jars
+    $ cd nightly-2022-03-03-0-github-java-jars
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar
+    $ tree
+    |__ arrow-format-8.0.0.dev165.jar
+    |__ arrow-vector-8.0.0.dev165.jar
+
+4. Install nightly java version to local maven repository with `mvn install:install-file`
+
+.. code-block:: shell
+
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-format-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-format \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-format/8.0.0.dev165/arrow-format-8.0.0.dev165.jar
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-vector-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-vector \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-vector/8.0.0.dev165/arrow-vector-8.0.0.dev165.jar
+
+6. Validate packages installed locally on maven repository:
+
+.. code-block:: shell
+
+    $ tree /Users/arrow/.m2/repository/org/apache/arrow
+    |__ arrow-format
+        |__ 8.0.0.dev165
+            |__ arrow-format-8.0.0.dev165.jar
+            |__ arrow-format-8.0.0.dev165.pom
+    |__ arrow-vector
+        |__ 8.0.0.dev165
+            |__ arrow-vector-8.0.0.dev165.jar
+            |__ arrow-vector-8.0.0.dev165.pom
+
+5. Compile your project with `mvn clean install`.
+
+.. code-block:: shell
+
+    $ mvn clean install
+    [INFO] BUILD SUCCESS
 
 Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.

Review comment:
       This should go up at the very top as part of the paragraph about GitHub. 
   
   ```
   Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
   The artifacts are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
   ```




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] davisusanibar commented on a change in pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
davisusanibar commented on a change in pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#discussion_r822095814



##########
File path: docs/source/java/install.rst
##########
@@ -81,39 +81,91 @@ Installing Nightly Packages
 .. warning::
     These packages are not official releases. Use them at your own risk.
 
-Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
+Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+The artifacts are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Maven cannot directly use the artifacts from GitHub.
+Instead, install them to the local Maven repository:
 
-.. code-block:: xml
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`
 
-    $ cat ~/.m2/settings.xml
-    <?xml version="1.0" encoding="UTF-8"?>
-    <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <profiles>
-        <profile>
-          <repositories>
-            <repository>
-               <id>staged</id>
-               <name>staged-releases</name>
-               <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
-               <releases>
-                 <enabled>true</enabled>
-               </releases>
-               <snapshots>
-                 <enabled>true</enabled>
-               </snapshots>
-             </repository>
-          </repositories>
-          <id>arrownightly</id>
-        </profile>
-      </profiles>
-    </settings>
-    $ mvn -Parrownightly clean install -X
-    Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+.. code-block:: xml
 
-Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <arrow.version>8.0.0.dev165</arrow.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-vector</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-format</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+    </dependencies>
+
+3. Download packages needed to a temporary directory
+
+.. code-block:: shell
+
+    $ mkdir nightly-2022-03-03-0-github-java-jars
+    $ cd nightly-2022-03-03-0-github-java-jars
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar
+    $ tree
+    |__ arrow-format-8.0.0.dev165.jar
+    |__ arrow-vector-8.0.0.dev165.jar
+
+4. Install the artifacts to the local Maven repository with ``mvn install:install-file``
+
+.. code-block:: shell
+
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-format-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-format \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-format/8.0.0.dev165/arrow-format-8.0.0.dev165.jar
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-vector-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-vector \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-vector/8.0.0.dev165/arrow-vector-8.0.0.dev165.jar
+
+6. Validate that the packages were installed:
+
+.. code-block:: shell
+
+    $ tree /Users/arrow/.m2/repository/org/apache/arrow
+    |__ arrow-format
+        |__ 8.0.0.dev165
+            |__ arrow-format-8.0.0.dev165.jar
+            |__ arrow-format-8.0.0.dev165.pom
+    |__ arrow-vector
+        |__ 8.0.0.dev165
+            |__ arrow-vector-8.0.0.dev165.jar
+            |__ arrow-vector-8.0.0.dev165.pom
+
+5. Compile your project with `mvn clean install`.
+
+.. code-block:: shell
+
+    $ mvn clean install
+    [INFO] BUILD SUCCESS

Review comment:
       Deleted




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] davisusanibar commented on a change in pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
davisusanibar commented on a change in pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#discussion_r822095990



##########
File path: docs/source/java/install.rst
##########
@@ -81,39 +81,91 @@ Installing Nightly Packages
 .. warning::
     These packages are not official releases. Use them at your own risk.
 
-Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
+Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+The artifacts are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
 
-To test your code with these artifacts, then configure Maven with:
+Maven cannot directly use the artifacts from GitHub.
+Instead, install them to the local Maven repository:
 
-.. code-block:: xml
+1. Decide nightly packages repository to use, for example: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-03-0-github-java-jars
+2. Define nightly packages to use, for example: `arrow-vector` and `arrow-format`
 
-    $ cat ~/.m2/settings.xml
-    <?xml version="1.0" encoding="UTF-8"?>
-    <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-      <profiles>
-        <profile>
-          <repositories>
-            <repository>
-               <id>staged</id>
-               <name>staged-releases</name>
-               <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
-               <releases>
-                 <enabled>true</enabled>
-               </releases>
-               <snapshots>
-                 <enabled>true</enabled>
-               </snapshots>
-             </repository>
-          </repositories>
-          <id>arrownightly</id>
-        </profile>
-      </profiles>
-    </settings>
-    $ mvn -Parrownightly clean install -X
-    Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+.. code-block:: xml
 
-Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <arrow.version>8.0.0.dev165</arrow.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-vector</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.arrow</groupId>
+            <artifactId>arrow-format</artifactId>
+            <version>${arrow.version}</version>
+        </dependency>
+    </dependencies>
+
+3. Download packages needed to a temporary directory
+
+.. code-block:: shell
+
+    $ mkdir nightly-2022-03-03-0-github-java-jars
+    $ cd nightly-2022-03-03-0-github-java-jars
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar
+    $ wget https://github.com/ursacomputing/crossbow/releases/download/nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar
+    $ tree
+    |__ arrow-format-8.0.0.dev165.jar
+    |__ arrow-vector-8.0.0.dev165.jar
+
+4. Install the artifacts to the local Maven repository with ``mvn install:install-file``
+
+.. code-block:: shell
+
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-format-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-format \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-format-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-format/8.0.0.dev165/arrow-format-8.0.0.dev165.jar
+    $ mvn install:install-file \
+        -Dfile="$(pwd)/arrow-vector-8.0.0.dev165.jar" \
+        -DgroupId=org.apache.arrow \
+        -DartifactId=arrow-vector \
+        -Dversion=8.0.0.dev165 \
+        -Dpackaging=jar \
+        -DcreateChecksum=true \
+        -Dgenerate.pom=true
+    [INFO] Installing /nightly-2022-03-03-0-github-java-jars/arrow-vector-8.0.0.dev165.jar to /Users/arrow/.m2/repository/org/apache/arrow/arrow-vector/8.0.0.dev165/arrow-vector-8.0.0.dev165.jar
+
+6. Validate that the packages were installed:

Review comment:
       Changed




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] ursabot commented on pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
ursabot commented on pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#issuecomment-1062960446


   Benchmark runs are scheduled for baseline = e8a1e1328f3c1bc6bf5ff7ba86057af3e37b634d and contender = a76794c1a3811a698130f95cf72dcbd6cc372a08. a76794c1a3811a698130f95cf72dcbd6cc372a08 is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
   Conbench compare runs links:
   [Scheduled] [ec2-t3-xlarge-us-east-2](https://conbench.ursa.dev/compare/runs/c001e11a003f466185fbb027138942fe...13214498df994262a0e689f0f8fc3b45/)
   [Scheduled] [test-mac-arm](https://conbench.ursa.dev/compare/runs/a644e510d5804d8bac84a19205cd0446...a0d3df74507a43269cb09e72336e9a20/)
   [Scheduled] [ursa-i9-9960x](https://conbench.ursa.dev/compare/runs/e81aa9271a134e7a8d19c35371079837...b685392d45b5478783c9727ec6b10907/)
   [Scheduled] [ursa-thinkcentre-m75q](https://conbench.ursa.dev/compare/runs/34a949ee67e247c9813e904c2b0cd8e2...4818dda29cdf482b890c481a14aaa0ea/)
   Supported benchmarks:
   ec2-t3-xlarge-us-east-2: Supported benchmark langs: Python. Runs only benchmarks with cloud = True
   test-mac-arm: Supported benchmark langs: C++, Python, R
   ursa-i9-9960x: Supported benchmark langs: Python, R, JavaScript
   ursa-thinkcentre-m75q: Supported benchmark langs: C++, Java
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] lidavidm closed pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
lidavidm closed pull request #12578:
URL: https://github.com/apache/arrow/pull/12578


   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] ursabot edited a comment on pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
ursabot edited a comment on pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#issuecomment-1062960446


   Benchmark runs are scheduled for baseline = e8a1e1328f3c1bc6bf5ff7ba86057af3e37b634d and contender = a76794c1a3811a698130f95cf72dcbd6cc372a08. a76794c1a3811a698130f95cf72dcbd6cc372a08 is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
   Conbench compare runs links:
   [Finished :arrow_down:0.0% :arrow_up:0.0%] [ec2-t3-xlarge-us-east-2](https://conbench.ursa.dev/compare/runs/c001e11a003f466185fbb027138942fe...13214498df994262a0e689f0f8fc3b45/)
   [Scheduled] [test-mac-arm](https://conbench.ursa.dev/compare/runs/a644e510d5804d8bac84a19205cd0446...a0d3df74507a43269cb09e72336e9a20/)
   [Scheduled] [ursa-i9-9960x](https://conbench.ursa.dev/compare/runs/e81aa9271a134e7a8d19c35371079837...b685392d45b5478783c9727ec6b10907/)
   [Scheduled] [ursa-thinkcentre-m75q](https://conbench.ursa.dev/compare/runs/34a949ee67e247c9813e904c2b0cd8e2...4818dda29cdf482b890c481a14aaa0ea/)
   Supported benchmarks:
   ec2-t3-xlarge-us-east-2: Supported benchmark langs: Python. Runs only benchmarks with cloud = True
   test-mac-arm: Supported benchmark langs: C++, Python, R
   ursa-i9-9960x: Supported benchmark langs: Python, R, JavaScript
   ursa-thinkcentre-m75q: Supported benchmark langs: C++, Java
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [arrow] ursabot edited a comment on pull request #12578: ARROW-15864: [Java][Docs] Update Arrow nightly Maven releases documentation

Posted by GitBox <gi...@apache.org>.
ursabot edited a comment on pull request #12578:
URL: https://github.com/apache/arrow/pull/12578#issuecomment-1062960446


   Benchmark runs are scheduled for baseline = e8a1e1328f3c1bc6bf5ff7ba86057af3e37b634d and contender = a76794c1a3811a698130f95cf72dcbd6cc372a08. a76794c1a3811a698130f95cf72dcbd6cc372a08 is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
   Conbench compare runs links:
   [Finished :arrow_down:0.0% :arrow_up:0.0%] [ec2-t3-xlarge-us-east-2](https://conbench.ursa.dev/compare/runs/c001e11a003f466185fbb027138942fe...13214498df994262a0e689f0f8fc3b45/)
   [Finished :arrow_down:0.21% :arrow_up:0.0%] [test-mac-arm](https://conbench.ursa.dev/compare/runs/a644e510d5804d8bac84a19205cd0446...a0d3df74507a43269cb09e72336e9a20/)
   [Scheduled] [ursa-i9-9960x](https://conbench.ursa.dev/compare/runs/e81aa9271a134e7a8d19c35371079837...b685392d45b5478783c9727ec6b10907/)
   [Finished :arrow_down:0.26% :arrow_up:0.0%] [ursa-thinkcentre-m75q](https://conbench.ursa.dev/compare/runs/34a949ee67e247c9813e904c2b0cd8e2...4818dda29cdf482b890c481a14aaa0ea/)
   Supported benchmarks:
   ec2-t3-xlarge-us-east-2: Supported benchmark langs: Python. Runs only benchmarks with cloud = True
   test-mac-arm: Supported benchmark langs: C++, Python, R
   ursa-i9-9960x: Supported benchmark langs: Python, R, JavaScript
   ursa-thinkcentre-m75q: Supported benchmark langs: C++, Java
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org