microsoft/generator-azuresfjava

Yeoman generator for scaffolding Azure Service Fabric Java projects

generator-azuresfjava

Yeoman generator for Azure Service Fabric Java projects

Installation

First, install Yeoman and generator-azuresfjava using npm (we assume you have pre-installed npm and node.js).

npm install -g yo
npm install -g generator-azuresfjava

The commands might ask for root access. Please run them with sudo, if needed.

Then generate your new project:

yo azuresfjava

You can have a look at our documentation to understand how can you build and deploy the generated Service Fabric Java application

Getting To Know Yeoman

• Yeoman has a heart of gold.
• Yeoman is a person with feelings and opinions, but is very easy to work with.
• Yeoman can be too opinionated at times but is easily convinced not to be.
• Feel free to learn more about Yeoman.

License

MIT Copyright (c) Microsoft Corporation. All rights reserved.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Steps to contribute

Once you have figured out all the legalities above, you can follow the steps below -

• Create a fork of this repository
• Git clone the forked repository to your development box
• Make the changes
• You can update your local Yeo using npm link (or sudo npm link as required) at the project root-level
• Create a new project with yo azuresfjava (ensure it picks Yeo node-module bits from your local changes)
• Validate that changes are working as expected and not breaking anything regressively - following the steps mentioned in the documentation by creating, building and deploying the generated project on a Service Fabric cluster
• Raise a pull request and share with us

Debugging generator using vscode

• Open the repository's root folder in VScode.
• Run the command which yo and update the program's value in launch.json if it does not match with yours.
• Press F5 to start debugging.

generator-azuresfjava's Issues

This repo is missing important files

There are important files that Microsoft projects should all have that are not present in this repository. A pull request has been opened to add the missing file(s). When the pr is merged this issue will be closed automatically.

Microsoft teams can learn more about this effort and share feedback within the open source guidance available internally.

Merge this pull request

Error running testclient.sh "Exception in thread "main" java.lang.UnsatisfiedLinkError: no jFabricCommon in java.library.path"

Using an unmodified generated Reliable Actor Service, the application generates and builds fine, but when attempting to run the testclient.sh (from tutorial documentation here) it gives the following error:

++ dirname ./testclient.sh
+ BASEDIR=.
+ cd .
++ pwd
+ export LD_LIBRARY_PATH=:/Users/stevena/source/azure/app-fabric/example1-java/azurejava-example1/MyactorsvcTestClient/out/lib/lib:/opt/microsoft/servicefabric/bin/Fabric/Fabric.Code/
+ LD_LIBRARY_PATH=:/Users/stevena/source/azure/app-fabric/example1-java/azurejava-example1/MyactorsvcTestClient/out/lib/lib:/opt/microsoft/servicefabric/bin/Fabric/Fabric.Code/
+ java -Djava.library.path=:/Users/stevena/source/azure/app-fabric/example1-java/azurejava-example1/MyactorsvcTestClient/out/lib/lib:/opt/microsoft/servicefabric/bin/Fabric/Fabric.Code/ -jar out/lib/myactorsvc-test.jar
Exception in thread "main" java.lang.UnsatisfiedLinkError: no jFabricCommon in java.library.path
	at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1867)
	at java.lang.Runtime.loadLibrary0(Runtime.java:870)
	at java.lang.System.loadLibrary(System.java:1122)
	at system.fabric.utility.LttngLogger.<clinit>(LttngLogger.java:113)
	at microsoft.servicefabric.services.remoting.builder.MethodDispatcherBuilder.<clinit>(MethodDispatcherBuilder.java:36)
	at microsoft.servicefabric.actors.remoting.builder.ActorCodeBuilder.<init>(ActorCodeBuilder.java:31)
	at microsoft.servicefabric.actors.remoting.builder.ActorCodeBuilder.<clinit>(ActorCodeBuilder.java:22)
	at microsoft.servicefabric.actors.remoting.client.FabricActorProxyFactory.createActorProxy(FabricActorProxyFactory.java:102)
	at microsoft.servicefabric.actors.client.ActorProxyBase.create(ActorProxyBase.java:268)
	at microsoft.servicefabric.actors.client.ActorProxyBase.create(ActorProxyBase.java:237)
	at reliableactor.test.MyactorsvcTestClient.main(MyactorsvcTestClient.java:19)

This is running from Mac OS, gradle builds fine and resolves deps without error.