> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/tools-ansible/tutorials/06__introducing_the_nat_gateway_and_network_load_balancer/02__create_app_servers_and_nlb.yml.md). # 02\_\_create\_app\_servers\_and\_nlb.yml.md The source files for this tutorial can be downloaded from its [GitHub repository](https://github.com/ionos-cloud/module-ansible/tree/master/docs/), or cloned into your current working directory using the command `git clone https://github.com/ionos-cloud/module-ansible.git` before changing into the `module-ansible/docs/tutorials/06__introducing_the_nat_gateway_and_network_load_balancer` sub-directory. {% code title="01\_\_create\_jumpbox\_and\_nlb.yml" overflow="wrap" lineNumbers="true" %} ```yml --- - hosts: localhost connection: local gather_facts: false vars_files: - ../vars.yml - vars.yml tasks: # ======================================================================= - name: Get information about the datacenter '{{ datacenter_name }}' ionoscloudsdk.ionoscloud.datacenter_info: filters: { 'properties.name': '{{ datacenter_name }}' } register: datacenter_info_response - name: Get information about the LANs in '{{ datacenter_name }}' ionoscloudsdk.ionoscloud.lan_info: datacenter: "{{ datacenter_name }}" register: lan_info_response - name: Set the fact 'public_lan' based on the above ansible.builtin.set_fact: public_lan: "{{ (lan_info_response | json_query(query))[0] }}" vars: query: "lans[?properties.name=='public']" - name: Set the fact 'secondary_lan' based on the above ansible.builtin.set_fact: secondary_lan: "{{ (lan_info_response | json_query(query))[0] }}" vars: query: "lans[?properties.name=='{{ lan.name }}']" # ======================================================================= # Create the 'app servers' defined in 'server_config.app_server' - name: Create the cloud-init file for our app servers ansible.builtin.template: src: templates/cloud-init--app-servers.j2 dest: cloud-init--app-servers.txt - name: Create the app servers specified in server_config.app_server ionoscloudsdk.ionoscloud.server: datacenter: "{{ datacenter_name }}" name: "{{ item.name }}" cores: "{{ item.cores }}" ram: "{{ item.ram }}" cpu_family: "{{ datacenter_info_response.datacenters[0].properties.cpu_architecture[0].cpu_family }}" disk_type: HDD volume_size: "5" image: "{{ image_alias }}" image_password: "{{ default_password }}" ssh_keys: - "{{ ssh_public_key }}" - "{{ lookup('file', 'temporary_id_rsa.pub') }}" lan: "{{ secondary_lan.id }}" nic_ips: - "{{ item.ip }}" user_data: "{{ lookup('file', item.user_data_file) | string | b64encode }}" state: present wait: true wait_timeout: "{{ wait_timeout }}" with_items: "{{ server_config.app_server }}" register: create_app_server_response # ======================================================================= # And finally create and minmally-configure a Network Load Balancer - name: Get information about our reserved IP Blocks ionoscloudsdk.ionoscloud.ipblock_info: filters: "{ 'properties.name': 'IP Block for {{ datacenter_name }}' }" register: ipblock_info_response - name: Set 'ip_block' based on the above ansible.builtin.set_fact: ip_block: "{{ ipblock_info_response.ipblocks[0].properties.ips }}" # see https://docs.ionos.com/ansible/api/network-load-balancer/network_load_balancer # --> the example really needs the lb_private_ips, too - name: Create Network Load Balancer --- sometimes, this can take a while (up to 15 or so minutes), so please don't interrupt this operation... ionoscloudsdk.ionoscloud.network_load_balancer: datacenter: "{{ datacenter_name }}" name: "{{ nlb.name }}" listener_lan: "{{ public_lan.id }}" ips: - "{{ ip_block[1] }}" target_lan: "{{ secondary_lan.id }}" lb_private_ips: - "{{ nlb.ip }}" # state: present wait: true wait_timeout: "{{ vnf_wait_timeout }}" register: create_nlb_response # Before we can create a forwarding rule, we need the list of destination IPs - name: Set 'target_ips' based on 'create_app_server_response' ansible.builtin.set_fact: target_ips: "{{ create_app_server_response | json_query(query) }}" vars: query: "results[].machines[].entities.nics.items[].properties.ips" # we need two separate set_fact calls to guarantee the targets are initialised # as an empty list before they are used in the second call... - name: Create targets list ansible.builtin.set_fact: targets_ssh: [] targets_http: [] - name: Add new JSON Objects to 'targets' ansible.builtin.set_fact: targets_ssh: "{{ targets_ssh + [{ 'ip': item[0], 'port': '22', 'weight': '100' }] }}" targets_http: "{{ targets_http + [{ 'ip': item[0], 'port': '80', 'weight': '100' }] }}" loop: "{{ target_ips }}" - name: Print target objects ansible.builtin.debug: msg: - "targets_ssh: {{ targets_ssh }}" - "targets_http: {{ targets_http }}" when: verbose_debugging # see https://docs.ionos.com/ansible/api/network-load-balancer/network_load_balancer_rule - name: Create Network Load Balancer Forwarding Rule for tcp/ssh ionoscloudsdk.ionoscloud.network_load_balancer_rule: name: "NLB SSH connections" algorithm: "ROUND_ROBIN" protocol: "TCP" listener_ip: "{{ ip_block[1] }}" listener_port: "22" targets: "{{ targets_ssh }}" datacenter: "{{ datacenter_name }}" network_load_balancer: "{{ create_nlb_response.network_load_balancer.id }}" wait: true wait_timeout: "{{ vnf_wait_timeout }}" register: nlb_forwarding_rule_response_ssh - name: Create Network Load Balancer Forwarding Rule for tcp/http ionoscloudsdk.ionoscloud.network_load_balancer_rule: name: "NLB HTTP connections" algorithm: "ROUND_ROBIN" protocol: "TCP" listener_ip: "{{ ip_block[1] }}" listener_port: "80" targets: "{{ targets_http }}" datacenter: "{{ datacenter_name }}" network_load_balancer: "{{ create_nlb_response.network_load_balancer.id }}" wait: true wait_timeout: "{{ vnf_wait_timeout }}" register: nlb_forwarding_rule_response_http - name: Print the newly-provisioned Load Balancer's public IP address ansible.builtin.debug: msg: - "The NLB's IP address is {{ ip_block[1] }}. To see its forwarding rule in action, run the" - "command `curl http://{{ ip_block[1] }}` two or more times _after_ you have configured" - "the app-servers via `ansible-playbook -i inventory.yml 03__configure_app_servers.yml" ``` {% endcode %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.ionos.com/cloud/tools-ansible/tutorials/06__introducing_the_nat_gateway_and_network_load_balancer/02__create_app_servers_and_nlb.yml.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.