{"id":20329766,"url":"https://github.com/f5devcentral/f5-digital-customer-engagement-center","last_synced_at":"2025-03-04T12:19:51.672Z","repository":{"id":43003670,"uuid":"315847325","full_name":"f5devcentral/f5-digital-customer-engagement-center","owner":"f5devcentral","description":"This Repository is used to hold F5 Digital Customer Engagement Labs and Guides","archived":false,"fork":false,"pushed_at":"2023-10-20T22:35:26.000Z","size":54475,"stargazers_count":25,"open_issues_count":0,"forks_count":23,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-01-14T15:18:19.245Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/f5devcentral.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"code_of_conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-25T06:20:24.000Z","updated_at":"2023-10-20T22:19:38.000Z","dependencies_parsed_at":"2025-01-14T15:18:24.327Z","dependency_job_id":"324f3e33-5150-4f77-ad24-52b672f137fe","html_url":"https://github.com/f5devcentral/f5-digital-customer-engagement-center","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f5devcentral%2Ff5-digital-customer-engagement-center","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f5devcentral%2Ff5-digital-customer-engagement-center/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f5devcentral%2Ff5-digital-customer-engagement-center/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f5devcentral%2Ff5-digital-customer-engagement-center/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/f5devcentral","download_url":"https://codeload.github.com/f5devcentral/f5-digital-customer-engagement-center/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241844524,"owners_count":20029668,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-14T20:13:25.198Z","updated_at":"2025-03-04T12:19:51.648Z","avatar_url":"https://github.com/f5devcentral.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# F5 Digital Customer Engagement Center Repository\nF5 Digital Engagement Center Code Repository\n\n[Project Documentation in ReadTheDocs](https://f5-digital-customer-engagement-center.readthedocs.io/en/latest/index.html)\n## Overview\nThis project will be utilized to demo and provide reusable configurations for F5 Digital Engagement Center labs and roadshows\n\n## Getting Started\nThis repository and its examples are meant to support a bring your own credentials approach.\nthe credentials can be obtained through an F5 UDF course deployment, or your own cloud credentials.\n\n## Installation\n\nThis project can be run with or without the provided container for development or [**devcontainer.**](https://code.visualstudio.com/docs/remote/containers)\n\n### Devcontainer TLDR\n  - Requirements:\n      - [vscode](https://code.visualstudio.com/)\n      - [ms-vscode-remote.vscode-remote-extensionpack](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack)\n      - [docker](https://www.docker.com/)\n      - [wsl2](https://docs.microsoft.com/en-us/windows/wsl/) on windows workstations\n  - Running:\n    - open vscode command pallet\n      - \u003eRemote-Containers: Rebuild and Reopen in Container\n## Usage\n\nThe project is meant to deliver a framework for creation solutions using common or customized modules.\n\n\n### Solutions\n  Each solution will:\n  - Explain which infrastructure it requires\n      - readme.md\n  - Provide step by step instructions to deploy the required infrastructure and configure it mirroring the scripts\n    - formatting for readthedocs\n  - Contain scripts to:\n    - Deploy the required infrastructure\n      - setup.sh\n    - Create the required configuration\n      - demo.sh\n          - demo script is meant to be a wrapper for the scripts you want to use to configure your deployed solution infrastructure.\n          the most common scenario of using ansible through a docker container, is permitted by the privileged devcontainer.\n    - Destroy the required infrastructure\n      - cleanup.sh\n  - Accept variables\n    - auto.tfvars.example\n      an example of available variables for the infrastructure\n  - Export variables\n    - Solutions should be addressable as terraform modules, this requires they output relevant connection information in a standardized way.\n  - Be responsible for any IAM objects needed\n  - Create and manage any security groups/firewall rules needed by the solution.\n  - Include defaults not present in the auto.tvfars when using terraform\n  - Provide an auto.tfvars example when using terraform\n\na sample solution template is available in **~/solutions/solution_template**\n\n---\n### Modules\nEach module will:\n- Attempt to use community or vendor supported modules first\n- Export consistent outputs following project naming [standards](contributing.md)\n- Include standalone examples\n- Work with existing networks\n---\n### Devcontainer\nThe container will:\n- provide current releases of:\n  - Terraform\n  - Ansible\n  - pre-commit\n  - aws-cli\n  - azure-cli\n  - gcloud-cli\n\n---\n## Development\n\nchecking for secrets as well as linting is performed by git pre-commit with the module requirements handled in the devcontainer.\n\ntesting pre-commit hooks:\n  ```bash\n  # test pre commit manually\n  pre-commit run -a -v\n  ```\nbuilding documentation:\n  ```bash\n  mkdir -p docs_local\n  #local\n  sphinx-build -b html $PWD docs_local/\n  #preview local\n  # non wsl normal file path volume\n  docker run -it --rm -d -p 80:80 --name docs -v $PWD/docs_local:/usr/share/nginx/html nginx\n  # wsl requires volume path to original dockerhost filesystem\n  docker run -it --rm -d -p 80:80 --name docs -v /c/github/f5-digital-customer-engagement-center/docs_local:/usr/share/nginx/html nginx\n  ```\n---\n## Troubleshooting\nmodule not pulling in changes:\n  - force module update\n    ```bash\n    terraform get -update\n    ```\n---\n## Support\nFor support, please open a GitHub issue.  Note, the code in this repository is community supported and is not supported by F5 Networks.  For a complete list of supported projects please reference [SUPPORT.md](SUPPORT.md).\n\n---\n## Community Code of Conduct\nPlease refer to the [F5 DevCentral Community Code of Conduct](code_of_conduct.md).\n\n---\n## License\n[Apache License 2.0](LICENSE)\n\n---\n## Copyright\nCopyright 2014-2020 F5 Networks Inc.\n\n---\n### F5 Networks Contributor License Agreement\n\nBefore you start contributing to any project sponsored by F5 Networks, Inc. (F5) on GitHub, you will need to sign a Contributor License Agreement (CLA).\n\nIf you are signing as an individual, we recommend that you talk to your employer (if applicable) before signing the CLA since some employment agreements may have restrictions on your contributions to other projects.\nOtherwise by submitting a CLA you represent that you are legally entitled to grant the licenses recited therein.\n\nIf your employer has rights to intellectual property that you create, such as your contributions, you represent that you have received permission to make contributions on behalf of that employer, that your employer has waived such rights for your contributions, or that your employer has executed a separate CLA with F5.\n\nIf you are signing on behalf of a company, you represent that you are legally entitled to grant the license recited therein.\nYou represent further that each employee of the entity that submits contributions is authorized to submit such contributions on behalf of the entity pursuant to the CLA.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff5devcentral%2Ff5-digital-customer-engagement-center","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff5devcentral%2Ff5-digital-customer-engagement-center","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff5devcentral%2Ff5-digital-customer-engagement-center/lists"}