|author||Owen Nichols <firstname.lastname@example.org>||Thu Feb 11 16:48:04 2021 -0800|
|committer||Owen Nichols <email@example.com>||Thu Feb 11 16:48:04 2021 -0800|
pair develop examples with 1.15.0 now that support/1.14 has been created
This is the home of Apache Geode examples that are bundled with the project. Contributions and corrections are welcome. Please talk to us about your suggestions at firstname.lastname@example.org or submit a pull request.
Geode client code must link against the same or older version of Geode as the Geode server it will connect to.
-PgeodeRepositoryUrl= -PgeodeVersion=1.12.0 to your
./gradlew command to specify which Geode client libraries to link, otherwise the default may be too new.
If the latest examples don't compile with your preferred version of Geode, use
git tag to list the available versions, then check out a suitable tag e.g.
git checkout rel/v1.12.0.
The gradle build will automatically download and install a Geode release in the
build directory. You can run an example with the following gradle targets:
build- compiles the example and runs unit tests
start- initializes the Geode cluster
run- runs the example Application
stop- shuts down the cluster
runAll- invokes start, run, stop
The commands you need to invoke will be given in the
README.md file. Sample usage:
$ ./gradlew :replicated:start $ ./gradlew :replicated:run $ ./gradlew :replicated:stop $ ./gradlew runAll $ ./gradlew runAll -PgeodeRepositoryUrl= -PgeodeVersion=1.12.0
The following sections call out ready-made examples or new examples that could be built. You may want to start your journey with the Apache Geode in 15 minutes or Less tutorial.
This section has self-contained little projects that illustrate a use case or an integration with other projects.
Follow this approach to add a new example:
README.mdfile in the example subproject to walk the user through the tutorial
settings.gradlefile to include subproject
README.mdfile to include the new example in the catalog of examples
The scripts should contain
gfsh commands for starting locators, servers, and creating regions--everything that the example program will need to use. Where appropriate you should also add unit tests. To customize the build you can add a
Verify that the examples build by executing
./gradlew runAll from the root directory. Note that the build may fail if you do not add ASF license headers or use the correct formatting. You can fix formatting with
This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.
The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.
The following provides more details on the included cryptographic software: