docs: update for ETSI public repository and fix stale references

3. [Forking and Submitting PRs](#forking-and-submitting-prs)

4. [Coding Standards](#coding-standards)

5. [Testing Your Changes](#testing-your-changes)

6. [Code of Conduct](#code-of-conduct)

---

You can contribute to this project in several ways:

- Submit bug reports or feature requests via [Issues](https://github.com/YOUR_REPO/issues)

- Submit bug reports or feature requests through the project issue tracker

- Fix bugs or add new features and open a pull request

- Update documentation to improve clarity

- Test existing playbooks and roles, suggesting improvements

1. **Clone the Repository**:

   ```bash

   git clone git@gitlab.i2cat.net:areas/software-networks/operator-platform/oop/op-automation.git

   cd i2CAT_OP_AUTOMATION

   git clone ssh://git@labs.etsi.org:29419/oop/deploy/ansible.git

   cd ansible

   ```

2. **Create a Feature Branch**:

---

## Code of Conduct

Please note this project follows a [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you agree to abide by these guidelines for fostering a welcoming and inclusive environment.

---

Thank you for contributing!

- deploy two-host federation setups

- fetch kubeconfigs back to local machine

This downstream repository keeps i2CAT-specific inventory and local defaults on

top of the public-safe upstream automation.

This repository contains the public Ansible automation for the ETSI OOP stack.

## Start here

ansible-galaxy collection install -r requirements.yml

cp inventory/hosts.yml inventory/hosts.local.yml

# Optional: only when private registry credentials or local paths are needed.

cp secrets.example.yml secrets.yml

ansible-playbook -i inventory/hosts.local.yml playbooks/scenarios/full_oop/deploy-kubernetes.yml --limit example_op_1

```

Set `artefact_manager_image` and `artefact_manager_tag` to a published image before

deploying. Set `lite2edge_image` as well when using the `lite2edge` profile.

## Working scenarios

- `playbooks/scenarios/dual_oop/deploy.yml`: two complete Operator Platforms on two hosts

- `ansible/secrets.yml` is optional, local-only, and gitignored.

- Copy `ansible/inventory/hosts.yml` to `ansible/inventory/hosts.local.yml` for site-specific inventory.

- Copy `ansible/secrets.example.yml` to `ansible/secrets.yml` only when local overrides are needed.

- Public defaults do not include private flavour images; provide image overrides in inventory, `secrets.yml`, or `-e`.

## Docs preview

mkdocs serve

```

## Author

Sergio Giménez <sergio.gimenez@i2cat.net>

## License

Apache 2.0. See `LICENSE`.

Apache 2.0. See `LICENSE` and `NOTICE` for attribution requirements.

One complete Operator Platform on a host that already has a running cluster.

```bash

ansible-playbook playbooks/scenarios/full_oop_existing_cluster/deploy.yml --limit openop_sunrise

ansible-playbook playbooks/scenarios/full_oop_existing_cluster/deploy.yml --limit openop_kul

ansible-playbook playbooks/scenarios/full_oop_existing_cluster/deploy.yml --limit example_existing_cluster

```

## Undeploy

- `existing_cluster_nodes`: hosts with an already running Kubernetes cluster

- `op1_nodes`: first host for `dual_oop`

- `op2_nodes`: second host for `dual_oop`

- `openop_dev`: optional host group for one-host `full_oop`

- `full_oop_nodes`: optional host group for one-host `full_oop`

## Notes

- name: Deploy All-in-One OOP (Dual Federation Managers)

  hosts: k8s_clusters

  gather_facts: true

  vars_files:

    - ../../../inventory/profiles/{{ oop_deployment_profile | default('lite2edge') }}.yml

  vars:

    # Scenario-specific configuration

    artifact_registry: zot

    edgecloud_platform: "{{ oop_profile_edgecloud_platform }}"

    srm_edge_cloud_adapter_name: "{{ oop_profile_srm_edge_cloud_adapter_name }}"

    srm_adapter_base_url: "{{ oop_profile_srm_adapter_base_url }}"

    federation_manager_ecp_host: "{{ oop_profile_federation_manager_ecp_host }}"

    federation_manager_ecp_port: "{{ oop_profile_federation_manager_ecp_port }}"

    federation_manager_ecp_client_name: "{{ oop_profile_federation_manager_ecp_client_name }}"

    prepare_oop_storage: true

  pre_tasks:

    # Artifact Registry

    - role: zot

      when: artifact_registry == 'zot'

      when: artifact_registry | default('zot') == 'zot'

      tags: [oop, artifact-registry, zot]

      # Other registries can be added such as harbor

          Components Deployed:

            ✓ K8s Cluster ({{ cluster_name }})

            ✓ Prometheus Monitoring

            ✓ Node Feature Discovery

            {% if artifact_registry | default('zot') == 'zot' %}✓ Zot Registry{% elif artifact_registry == 'harbor' %}✓ Harbor Registry{% else %}⊘ Artifact Registry (skipped){% endif %}

            {% if artifact_registry | default('zot') == 'zot' %}✓ Zot Registry{% elif artifact_registry | default('') == 'harbor' %}✓ Harbor Registry{% else %}⊘ Artifact Registry (skipped){% endif %}

            ✓ Artefact Manager

            ✓ SRM Controller

          Access Points:

            Kubeconfig: {{ kubeconfig_dir }}/{{ kubeconfig_filename }}

            Prometheus: http://{{ host_ip }}:30090

            Grafana: http://{{ host_ip }}:30091

            Homer: http://{{ host_ip }}:{{ homer_nodeport }}

          Federation Testing:

- **Variable Organization**: See `inventory/group_vars/README.md`

- **Playbook Scenarios**: See `playbooks/scenarios/README.md`

- **Testing Summary**: See `TESTING_SUMMARY.md` in project root

- **Role Refactoring**: See `ROLE_REFACTORING.md` in project root

---