README.md
This repo contains JBoss EAP Marketplace templates for use on Azure Marketplace. Each subdirectory corresponds to one of the offered plans.
Deployment Description
There are three different types of EAP on VM offers based on their outcomes.
Type | Offer | Description |
---|---|---|
on VMs | JBoss EAP standalone on RHEL VM(PAYG/BYOS) | Deployment description |
on VMs | JBoss EAP Cluster on VM Scale Sets(PAYG/BYOS) | Deployment description |
on VMs | JBoss EAP Cluster on VMs(PAYG/BYOS) | Deployment description |
on ARO | JBoss EAP on ARO | Deployment description |
Local Build Setup and Requirements
This project utilizes GitHub Packages for hosting and retrieving some dependencies. To ensure you can smoothly run and build the project in your local environment, specific configuration settings are required.
GitHub Packages requires authentication to download or publish packages. Therefore, you need to configure your Maven settings.xml
file to authenticate using your GitHub credentials. The primary reason for this is that GitHub Packages does not support anonymous access, even for public packages.
Please follow these steps:
-
Create a Personal Access Token (PAT)
- Go to Personal access tokens.
- Click on Generate new token.
- Give your token a descriptive name, set the expiration as needed, and select the scopes (read:packages, write:packages).
- Click Generate token and make sure to copy the token.
-
Configure Maven Settings
- Locate or create the settings.xml file in your .m2 directory(~/.m2/settings.xml).
- Add the GitHub Package Registry server configuration with your username and the PAT you just created. It should look something like this:
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd"> <!-- other settings ... --> <servers> <server> <id>github</id> <username>YOUR_GITHUB_USERNAME</username> <password>YOUR_PERSONAL_ACCESS_TOKEN</password> </server> </servers> <!-- other settings ... --> </settings>
Build zipped offers
- Clean up the folder offers. This step is optional.
- Execute ./GenerateOffers.ps1
- This powershell script will iterate through all the folders which have eap in it's name.
- For each folder, it'll add all the files except parameters file to a zip folder.
- It will store the zip inside offers directory.
- These zip files from the offers directory can then be published.
Deploying from local machine
- Run Connect-AzAccount to login
- Run Set-AzContext -Subscription <subscriptionid>
create a parameters file
.<offer name>
|-azuredeploy.parameters.dev.json
This file should contain values for all the parameters
{
"location": {
"value": "southeastasia"
},
"vmName": {
"value": "jbvm"
},
"asName": {
"value": "jbas"
},
"adminUsername": {
"value": "azlinux"
},
"authenticationType": {
"value": "sshPublicKey"
},
"adminPasswordOrSSHKey": {
"value": "<Public ssh key>"
},
"vmSize": {
"value": "Standard_DS2_v2"
},
"numberOfInstances": {
"value": 3
},
"virtualNetworkNewOrExisting": {
"value": "existing"
},
"virtualNetworkName": {
"value": "pb-rg2-vnet"
},
"addressPrefixes": {
"value": [
"172.18.0.0/16"
]
},
"subnetName": {
"value": "default"
},
"subnetPrefix": {
"value": "172.18.0.0/24"
},
"virtualNetworkResourceGroupName": {
"value": "pbasnal-rg2"
},
"bootDiagnostics": {
"value": "on"
},
"bootStorageNewOrExisting": {
"value": "existing"
},
"bootStorageAccountName": {
"value": "jbbootdiag"
},
"bootStorageReplication": {
"value": "Standard_RAGRS"
},
"bootStorageAccountResourceGroup": {
"value": "pbasnal-rg"
},
"jbossEAPUserName": {
"value": "azlinux"
},
"jbossEAPPassword": {
"value": "********"
},
"rhsmUserName": {
"value": "pbasnal-msft"
},
"rhsmPassword": {
"value": "******"
},
"rhsmPoolEAP": {
"value": ""
},
"rhsmPoolRHEL": {
"value": ""
}
}
.\Deploy-AzTemplate.ps1 -ArtifactStagingDirectory .\eap74-rhel8-payg-multivm -ResourceGroupLocation southeastasia -dev -UploadArtifacts
Validating templates
You can use the Azure Resource Manager Template Toolkit (arm-ttk
) to validate the templates. You'll need to have installed Powershell (for Mac, Windows, Linux).
- Donwload the latest TTK from https://aka.ms/arm-ttk-latest
- Extract it somewhere
- Move into the
ttk/arm-ttk
directory (e.g.cd ttk/arm-ttk
) - Run Powershell
- Within Powershell, execute
Import-Module ./arm-ttk.psd1
- To validate one of the offers, run
Test-AzTemplate -TemplatePath [PATH TO OFFER BASE DIRECTORY]
The GitHub Actions file in this repo does the same on pull requests or pushes.
Merge policy
- Squash and merge