You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[View a larger version of this image](/images/gitea-ec-ready.png)
109
-
110
-
## Install Behind a Proxy Server {#proxy}
111
-
112
-
The following flags can be used with the Embedded Cluster `install` command to install behind a proxy server:
113
-
114
-
<table>
115
-
<tr>
116
-
<thwidth="35%">Flag</th>
117
-
<thwidth="65%">Description</th>
118
-
</tr>
119
-
<tr>
120
-
<td>`--http-proxy`</td>
121
-
<td>Proxy server to use for HTTP</td>
122
-
</tr>
123
-
<tr>
124
-
<td>`--https-proxy`</td>
125
-
<td>Proxy server to use for HTTPS</td>
126
-
</tr>
127
-
<tr>
128
-
<td>`--no-proxy`</td>
129
-
<td>
130
-
<p>Comma-separated list of hosts for which not to use a proxy.</p>
131
-
<p>For single-node installations, pass the IP address of the node where you are installing. For multi-node installations, when deploying the first node, pass the list of IP addresses for all nodes in the cluster (typically in CIDR notation).</p>
132
-
<p>The following are never proxied:</p>
133
-
<ul>
134
-
<li>Internal cluster communication (`localhost`, `127.0.0.1`, `.cluster.local`, `.svc`)</li>
135
-
<li>The CIDRs used for assigning IPs to Kubernetes Pods and Services. By default, the Pod CIDR is `10.244.0.0/16` and the Service CIDR `10.96.0.0/12`. For information about how to change these defaults, see [Set IP Address Ranges for Pods and Services](#set-ip-address-ranges-for-pods-and-services).</li>
136
-
</ul>
137
-
<p>To ensure your app's internal cluster communication is not proxied, use fully qualified domain names like `my-service.my-namespace.svc` or `my-service.my-namespace.svc.cluster.local`.</p>
138
-
</td>
139
-
</tr>
140
-
</table>
141
-
142
-
#### Example
143
-
144
-
```bash
145
-
sudo ./APP_SLUG install --license LICENSE_FILE \
146
-
--http-proxy=HOST:PORT \
147
-
--https-proxy=HOST:PORT \
148
-
--no-proxy=LIST_OF_HOSTS
149
-
```
150
-
151
-
Where:
152
-
153
-
*`LICENSE_FILE` is the customer's license
154
-
*`HOST:PORT` is the host and port of the proxy server
155
-
*`LIST_OF_HOSTS` is the list of hosts to not proxy. For example, the IP address of the node where you are installing. Or, for multi-node clusters, the list of IP addresses for all nodes in the cluster, typically in CIDR notation.
156
-
157
-
#### Requirement
158
-
159
-
Proxy installations require Embedded Cluster 1.5.1 or later with Kubernetes 1.29 or later. For example, Embedded Cluster 1.6.0+k8s-1.29 supports installing behind a proxy, and 1.6.0+k8s-1.28 does not. For the latest version information, see [Embedded Cluster Release Notes](/release-notes/rn-embedded-cluster).
160
-
161
-
#### Limitations
162
-
163
-
* If any of your Helm extensions make requests to the internet, the given charts need to be manually configured so that those requests are made to the user-supplied proxy server instead. Typically, this requires updating the Helm values to set HTTP proxy, HTTPS proxy, and no proxy.
164
-
165
-
Note that this limitation applies only to network requests made by your Helm extensions. The proxy settings supplied to the install command are used to pull the containers required to run your Helm extensions.
166
-
167
-
* Proxy settings cannot be changed after installation or during upgrade.
168
-
169
-
### Set IP Address Ranges for Pods and Services
170
-
171
-
The following flags can be used with the Embedded Cluster `install` command to allocate IP address ranges for Pods and Services:
172
-
173
-
<table>
174
-
<tr>
175
-
<thwidth="35%">Flag</th>
176
-
<thwidth="65%">Description</th>
177
-
</tr>
178
-
<tr>
179
-
<td>`--pod-cidr`</td>
180
-
<td>The range of IP addresses that can be assigned to Pods, in CIDR notation. By default, the Pod CIDR is `10.244.0.0/16`.</td>
181
-
</tr>
182
-
<tr>
183
-
<td>`--service-cidr`</td>
184
-
<td>The range of IP addresses that can be assigned to Services, in CIDR notation. By default, the Service CIDR is `10.96.0.0/12`.</td>
The `--pod-cidr` and `--service-cidr` flags are not supported on Red Hat Enterprise Linux (RHEL) 9 operating systems.
198
-
199
-
## Change Admin Console and LAM Ports {#adm-lam-ports}
200
-
201
-
By default, the Admin Console and Local Artifact Mirror (LAM) run on ports 30000 and 50000, respectively. If these ports are occupied, you can select different ports.
202
-
203
-
To choose different ports for the Admin Console and LAM during installation with Embedded Cluster, use the `--admin-console-port` and `--local-artifact-mirror-port` flags with the Embedded Cluster `install` command.
The Embedded Cluster host preflight checks verify the default ports or the user-supplied ports, so users will be alerted before installation if they need to choose new port(s). For more information about the host preflight checks for Embedded Cluster, see [About Host Preflight Checks](/vendor/embedded-overview#about-host-preflight-checks).
212
-
213
-
### Limitation
214
-
215
-
It is not possible to change the port for the Admin Console during a restore with Embedded Cluster. For more information, see [Disaster Recovery for Embedded Cluster (Alpha)](/vendor/embedded-disaster-recovery).
216
-
217
-
## Change the Default Data Directory {#data-dir}
218
-
219
-
The default location of the data directory for Embedded Cluster is `/var/lib/embedded-cluster`.
220
-
221
-
This directory can be modified by the user by passing the `--data-dir` flag to the `install` command.
* The data directory for Embedded Cluster cannot be changed after the cluster is installed.
233
-
234
-
* If you use the `--data-dir` flag to change the data directory during installation, then you must use the same location when restoring in a disaster recovery scenario. For more information about disaster recovery with Embedded Cluster, see [Disaster Recovery for Embedded Cluster](/vendor/embedded-disaster-recovery).
235
-
236
-
* Replicated does not support using symlinks for the Embedded Cluster data directory. Use the `--data-dir` flag instead of symlinking `/var/lib/embedded-cluster`.
108
+
[View a larger version of this image](/images/gitea-ec-ready.png)
<li>Internal cluster communication (`localhost`, `127.0.0.1`, `.cluster.local`, `.svc`)</li>
77
77
<li>The CIDRs used for assigning IPs to Kubernetes Pods and Services. By default, the Pod CIDR is `10.244.0.0/16` and the Service CIDR `10.96.0.0/12`. For information about how to change these defaults, see [Set IP Address Ranges for Pods and Services](#set-ip-address-ranges-for-pods-and-services).</li>
78
78
</ul>
79
-
<p>To ensure your app's internal cluster communication is not proxied, use fully qualified domain names like `my-service.my-namespace.svc` or `my-service.my-namespace.svc.cluster.local`.</p>
79
+
<p>To ensure your application's internal cluster communication is not proxied, use fully qualified domain names like `my-service.my-namespace.svc` or `my-service.my-namespace.svc.cluster.local`.</p>
0 commit comments