|
1 | | -:description: Deploy Neo4j on Microsoft Azure directly from the Azure Marketplace or by using the Neo4j Azure Resource Manager (ARM) template hosted on GitHub. |
2 | | -[[azure]] |
3 | | -= Neo4j on Azure |
| 1 | +//Neo4j is supported on Microsoft Azure only for version 5.26 LTS. This page is kept only in case of future support. |
| 2 | +//================================ |
| 3 | +//================================ |
| 4 | +// :description: Deploy Neo4j on Microsoft Azure directly from the Azure Marketplace or by using the Neo4j Azure Resource Manager (ARM) template hosted on GitHub. |
| 5 | +// [[azure]] |
| 6 | +// = Neo4j on Azure |
4 | 7 |
|
5 | | -Neo4j can be easily deployed on Virtual Machine instances in Microsoft Azure by using the link:https://azuremarketplace.microsoft.com/en-us/marketplace/apps/neo4j.neo4j-ee?tab=Overview[official listing for Neo4j Enterprise] on the Azure Marketplace. |
| 8 | +// Neo4j can be easily deployed on Virtual Machine instances in Microsoft Azure by using the link:https://azuremarketplace.microsoft.com/en-us/marketplace/apps/neo4j.neo4j-ee?tab=Overview[official listing for Neo4j Enterprise] on the Azure Marketplace. |
6 | 9 |
|
7 | | -The Azure Marketplace listing uses an Azure Resource Manager (ARM) template maintained by Neo4j. |
8 | | -The template's code is available on link:https://github.com/neo4j-partners/azure-resource-manager-neo4j/tree/main/marketplace[GitHub] and can be customized to meet more complex or bespoke use cases. |
| 10 | +// The Azure Marketplace listing uses an Azure Resource Manager (ARM) template maintained by Neo4j. |
| 11 | +// The template's code is available on link:https://github.com/neo4j-partners/azure-resource-manager-neo4j/tree/main/marketplace[GitHub] and can be customized to meet more complex or bespoke use cases. |
9 | 12 |
|
10 | 13 |
|
11 | | -[NOTE] |
12 | | -==== |
13 | | -Neo4j does not provide Azure Marketplace Virtual Machine Images with a pre-installed version of the product. |
14 | | -The Neo4j Azure Marketplace listings (and listings on GitHub) use Azure Resource Manager (ARM) templates that deploy and configure Neo4j dynamically with a shell script. |
15 | | -==== |
| 14 | +// [NOTE] |
| 15 | +// ==== |
| 16 | +// Neo4j does not provide Azure Marketplace Virtual Machine Images with a pre-installed version of the product. |
| 17 | +// The Neo4j Azure Marketplace listings (and listings on GitHub) use Azure Resource Manager (ARM) templates that deploy and configure Neo4j dynamically with a shell script. |
| 18 | +// ==== |
16 | 19 |
|
17 | | -== Supported Neo4j versions |
| 20 | +// == Supported Neo4j versions |
18 | 21 |
|
19 | | -The Neo4j link:https://azuremarketplace.microsoft.com/en-us/marketplace/apps/neo4j.neo4j-ee?tab=Overview[Azure marketplace listing] can be configured to deploy either Neo4j Enterprise Edition 5 or 4.4. |
20 | | -The ARM template always installs the latest available version. |
| 22 | +// The Neo4j link:https://azuremarketplace.microsoft.com/en-us/marketplace/apps/neo4j.neo4j-ee?tab=Overview[Azure marketplace listing] can be configured to deploy either Neo4j Enterprise Edition 5 or 4.4. |
| 23 | +// The ARM template always installs the latest available version. |
21 | 24 |
|
22 | | -== Neo4j ARM template |
| 25 | +// == Neo4j ARM template |
23 | 26 |
|
24 | | -Azure Resource Manager (ARM) is a declarative Infrastructure as Code (IaC) language that is based on JSON and instructs Azure to deploy a set of cloud resources. |
| 27 | +// Azure Resource Manager (ARM) is a declarative Infrastructure as Code (IaC) language that is based on JSON and instructs Azure to deploy a set of cloud resources. |
25 | 28 |
|
26 | | -The Neo4j ARM template takes several parameters as inputs, deploys a set of cloud resources, and provides outputs that can be used to connect to a Neo4j DBMS. |
| 29 | +// The Neo4j ARM template takes several parameters as inputs, deploys a set of cloud resources, and provides outputs that can be used to connect to a Neo4j DBMS. |
27 | 30 |
|
28 | | -=== Important considerations |
| 31 | +// === Important considerations |
29 | 32 |
|
30 | | -* The deployment of cloud resources incurs costs. |
31 | | -** Refer to the link:https://azure.microsoft.com/en-gb/pricing/calculator/[Azure pricing calculator]for more information. |
| 33 | +// * The deployment of cloud resources incurs costs. |
| 34 | +// ** Refer to the link:https://azure.microsoft.com/en-gb/pricing/calculator/[Azure pricing calculator]for more information. |
32 | 35 |
|
33 | | -* You need to create a resource group. |
34 | | -** You need to choose an empty resource group or create a new one. |
| 36 | +// * You need to create a resource group. |
| 37 | +// ** You need to choose an empty resource group or create a new one. |
35 | 38 |
|
36 | | -* An active Azure subscription is required. |
| 39 | +// * An active Azure subscription is required. |
37 | 40 |
|
38 | | -=== Input parameters (Instance Details) |
| 41 | +// === Input parameters (Instance Details) |
39 | 42 |
|
40 | | -[cols="<31s,69",frame="topbot",options="header"] |
41 | | -|=== |
| 43 | +// [cols="<31s,69",frame="topbot",options="header"] |
| 44 | +// |=== |
42 | 45 |
|
43 | | -| Parameter Name |
44 | | -| Description |
| 46 | +// | Parameter Name |
| 47 | +// | Description |
45 | 48 |
|
46 | | -| Region |
47 | | -| The Azure region in which cloud resources should be deployed. |
| 49 | +// | Region |
| 50 | +// | The Azure region in which cloud resources should be deployed. |
48 | 51 |
|
49 | | -| Admin password |
50 | | -| A password for the `neo4j` user. The password must be between 12 and 72 characters long, and contain characters from at least 3 of the following groups: uppercase characters, lowercase characters, numbers, and special characters. |
51 | | -|=== |
| 52 | +// | Admin password |
| 53 | +// | A password for the `neo4j` user. The password must be between 12 and 72 characters long, and contain characters from at least 3 of the following groups: uppercase characters, lowercase characters, numbers, and special characters. |
| 54 | +// |=== |
52 | 55 |
|
53 | | -=== Input parameters (Neo4j Config) |
| 56 | +// === Input parameters (Neo4j Config) |
54 | 57 |
|
55 | | -[cols="<31s,69",frame="topbot",options="header"] |
56 | | -|=== |
| 58 | +// [cols="<31s,69",frame="topbot",options="header"] |
| 59 | +// |=== |
57 | 60 |
|
58 | | -| Parameter Name |
59 | | -| Description |
| 61 | +// | Parameter Name |
| 62 | +// | Description |
60 | 63 |
|
61 | | -| Virtual Machine Size |
62 | | -| The class of Azure VM Instances to use. |
| 64 | +// | Virtual Machine Size |
| 65 | +// | The class of Azure VM Instances to use. |
63 | 66 |
|
64 | | -| Node Count |
65 | | -| The number of desired Virtual Machine instances to be used to form a Neo4j cluster (a minimum of 3 instances is required to form a cluster). |
| 67 | +// | Node Count |
| 68 | +// | The number of desired Virtual Machine instances to be used to form a Neo4j cluster (a minimum of 3 instances is required to form a cluster). |
66 | 69 |
|
67 | | -| Disk Size |
68 | | -| Size (in GB) of the secondary volume on each Azure VM instance. |
| 70 | +// | Disk Size |
| 71 | +// | Size (in GB) of the secondary volume on each Azure VM instance. |
69 | 72 |
|
70 | | -| Graph Database Version |
71 | | -| Select either 5 or 4.4. |
| 73 | +// | Graph Database Version |
| 74 | +// | Select either 5 or 4.4. |
72 | 75 |
|
73 | | -| Install Graph Data Science |
74 | | -| An option to install Graph Data Science (GDS). Accepted values are `Yes` or `No`. |
| 76 | +// | Install Graph Data Science |
| 77 | +// | An option to install Graph Data Science (GDS). Accepted values are `Yes` or `No`. |
75 | 78 |
|
76 | | -| Graph Data Science License Key |
77 | | -| A valid GDS license key can be pasted into this field. License keys will be sent to and stored by Neo4j. This information is used only for product activation purposes. |
| 79 | +// | Graph Data Science License Key |
| 80 | +// | A valid GDS license key can be pasted into this field. License keys will be sent to and stored by Neo4j. This information is used only for product activation purposes. |
78 | 81 |
|
79 | | -| Install Bloom |
80 | | -| Optionally install Neo4j Bloom. Accepted values are `Yes` or `No`. |
| 82 | +// | Install Bloom |
| 83 | +// | Optionally install Neo4j Bloom. Accepted values are `Yes` or `No`. |
81 | 84 |
|
82 | | -| Bloom License Key |
83 | | -| A valid Bloom license key can be pasted into this field. License keys will be sent to and stored by Neo4j. This information is used only for product activation purposes. |
84 | | -|=== |
| 85 | +// | Bloom License Key |
| 86 | +// | A valid Bloom license key can be pasted into this field. License keys will be sent to and stored by Neo4j. This information is used only for product activation purposes. |
| 87 | +// |=== |
85 | 88 |
|
86 | | -=== Deployed cloud resources |
| 89 | +// === Deployed cloud resources |
87 | 90 |
|
88 | | -The environment created by the ARM template consists of the following Azure resources: |
| 91 | +// The environment created by the ARM template consists of the following Azure resources: |
89 | 92 |
|
90 | | -* 1 Virtual Network, with a CIDR range (address space) of `10.0.0.0/8`. |
91 | | -** A single subnet with the following CIDR range: |
92 | | -*** `10.0.0.0/16` |
93 | | -** A network security group. |
94 | | -* A Virtual Machine Scale-Set (VMSS), which creates: |
95 | | -** 1, or between 3 and 10 Virtual Machine instances (Depending on whether a single instance or an autonomous cluster is selected). |
96 | | -* 1 Load Balancer. |
| 93 | +// * 1 Virtual Network, with a CIDR range (address space) of `10.0.0.0/8`. |
| 94 | +// ** A single subnet with the following CIDR range: |
| 95 | +// *** `10.0.0.0/16` |
| 96 | +// ** A network security group. |
| 97 | +// * A Virtual Machine Scale-Set (VMSS), which creates: |
| 98 | +// ** 1, or between 3 and 10 Virtual Machine instances (Depending on whether a single instance or an autonomous cluster is selected). |
| 99 | +// * 1 Load Balancer. |
97 | 100 |
|
98 | | -=== Template outputs |
| 101 | +// === Template outputs |
99 | 102 |
|
100 | | -After the deployment finishes successfully, the ARM template provides the following outputs, which can be found in the *Outputs* section of the deployments page in the Azure console. |
| 103 | +// After the deployment finishes successfully, the ARM template provides the following outputs, which can be found in the *Outputs* section of the deployments page in the Azure console. |
101 | 104 |
|
102 | | -[NOTE] |
103 | | -==== |
104 | | -At the end of the deployment process, Azure runs a validation. |
105 | | -If the validation fails, it might be because you have chosen VMs that are too large and exceed your Azure quota. |
106 | | -==== |
| 105 | +// [NOTE] |
| 106 | +// ==== |
| 107 | +// At the end of the deployment process, Azure runs a validation. |
| 108 | +// If the validation fails, it might be because you have chosen VMs that are too large and exceed your Azure quota. |
| 109 | +// ==== |
107 | 110 |
|
108 | | -[cols="<31s,69",frame="topbot",options="header"] |
109 | | -|=== |
| 111 | +// [cols="<31s,69",frame="topbot",options="header"] |
| 112 | +// |=== |
110 | 113 |
|
111 | | -| Output Name |
112 | | -| Output Description |
| 114 | +// | Output Name |
| 115 | +// | Output Description |
113 | 116 |
|
114 | | -| neo4jBrowserURL |
115 | | -| The http URL of the Neo4j Browser. |
| 117 | +// | neo4jBrowserURL |
| 118 | +// | The http URL of the Neo4j Browser. |
116 | 119 |
|
117 | | -| username |
118 | | -| The username `neo4j` which is required to log into the Neo4j Browser. |
| 120 | +// | username |
| 121 | +// | The username `neo4j` which is required to log into the Neo4j Browser. |
119 | 122 |
|
120 | | -|=== |
| 123 | +// |=== |
121 | 124 |
|
122 | | -== Cluster version consistency |
| 125 | +// == Cluster version consistency |
123 | 126 |
|
124 | | -When the ARM template creates a new Neo4j cluster, a Virtual Machine Scale Set (VMSS) is created and tagged with the minor version of the installed Neo4j database. |
125 | | -If you add more VM instances to your VMSS, they will be installed using the same minor version, ensuring that all Neo4j cluster servers are installed with the same version, regardless of when the VM instances were created. |
| 127 | +// When the ARM template creates a new Neo4j cluster, a Virtual Machine Scale Set (VMSS) is created and tagged with the minor version of the installed Neo4j database. |
| 128 | +// If you add more VM instances to your VMSS, they will be installed using the same minor version, ensuring that all Neo4j cluster servers are installed with the same version, regardless of when the VM instances were created. |
126 | 129 |
|
127 | 130 |
|
128 | | -[role=label--enterprise-edition] |
129 | | -== Licensing |
| 131 | +// [role=label--enterprise-edition] |
| 132 | +// == Licensing |
130 | 133 |
|
131 | | -// label:Enterprise[] |
| 134 | +// // label:Enterprise[] |
132 | 135 |
|
133 | | -Installing and starting Neo4j from the Azure marketplace constitutes an acceptance of the Neo4j license agreement. |
134 | | -When deploying Neo4j, users are required to confirm that they either have an enterprise license. |
| 136 | +// Installing and starting Neo4j from the Azure marketplace constitutes an acceptance of the Neo4j license agreement. |
| 137 | +// When deploying Neo4j, users are required to confirm that they either have an enterprise license. |
135 | 138 |
|
136 | | -If you require the Enterprise version of either Graph Data Science or Bloom, you need to provide a key issued by Neo4j as this will be required during the installation. |
| 139 | +// If you require the Enterprise version of either Graph Data Science or Bloom, you need to provide a key issued by Neo4j as this will be required during the installation. |
137 | 140 |
|
138 | | -To obtain a valid license for either Neo4j, Bloom, or GDS, reach out to your Neo4j account representative or get in touch using the link:https://neo4j.com/contact-us/[contact form]. |
| 141 | +// To obtain a valid license for either Neo4j, Bloom, or GDS, reach out to your Neo4j account representative or get in touch using the link:https://neo4j.com/contact-us/[contact form]. |
139 | 142 |
|
140 | | -== Delete Azure deployment Stack and destroy resources |
| 143 | +// == Delete Azure deployment Stack and destroy resources |
141 | 144 |
|
142 | | -In order to completely delete the deployment, the resource group can be deleted. |
| 145 | +// In order to completely delete the deployment, the resource group can be deleted. |
0 commit comments