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.