1
0
mirror of https://github.com/openshift/installer.git synced 2026-02-05 06:46:36 +01:00

aws/publicIpv4Pool/doc: basic user docs

User documentation for the Public IPv4 Pool feature (BYOIPv4)
on install-config, where the customer can specify the Public IPv4 Pool
ID from a Public IPv4 CIDR pool that had bought to the AWS account.
This commit is contained in:
Marco Braga
2024-02-09 00:45:43 -03:00
parent 1edc5d439a
commit e0a520b89e

View File

@@ -0,0 +1,38 @@
# Install OpenShift on AWS using custom/owned Public IPv4 Pool
Steps to create a cluster on AWS using Public IPv4 address pool
that you bring to your AWS account with BYOIP.
## Prerequisites
- Public IPv4 Pool Provisioned in the Account
- Total of ( (Zones*3 ) + 1) of Public IPv4 available in the pool, where: Zones is the total numbber of AWS zones used to deploy the OpenShift cluster.
- Example to query the IPv4 pools available in the account, which returns the `TotalAvailableAddressCount`:
```
aws ec2 describe-public-ipv4-pools --region us-east-1
```
## Steps
- Create the install config setting the field `platform.aws.publicIpv4PoolId`, and create the cluster:
```yaml
apiVersion: v1
baseDomain: ${CLUSTER_BASE_DOMAIN}
metadata:
name: ocp-byoip
platform:
aws:
region: ${REGION}
publicIpv4Pool: ipv4pool-ec2-123456789abcde
publish: External
pullSecret: '...'
sshKey: |
'...'
```
- Create the cluster
```sh
openshift-install create cluster
```