{
  "markdown": "<!-- Copyright (c) Microsoft Corporation. -->\n<!-- Licensed under the MIT License. -->\n\n# SAP Deployment Automation Framework\n\nThe SAP deployment automation framework on Azure is an open-source orchestration tool for deploying, installing and maintaining SAP environments. You can create infrastructure for SAP landscapes based on SAP HANA and NetWeaver with AnyDB on any of the SAP-supported operating system versions and deploy them into any Azure region.\n\nThe framework uses Terraform for infrastructure deployment, and Ansible for the operating system and application configuration.\n\n![Ansible Lint](https://github.com/Azure/sap-automation/workflows/Ansible%20Lint/badge.svg)\n[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/azure/sap-automation.svg)](http://isitmaintained.com/project/azure/sap-automation \"Average time to resolve an issue\")\n[![Percentage of issues still open](http://isitmaintained.com/badge/open/azure/sap-automation.svg)](http://isitmaintained.com/project/azure/sap-automation \"Percentage of issues still open\")\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Azure/sap-automation/badge)](https://scorecard.dev/viewer/?uri=github.com/Azure/sap-automation)\n\n## Choose how to run SDAF\n\nSDAF supports three execution models. Each model deploys the same framework\ncomponents, but the setup, configuration generation, identity, and approval\nprocesses differ.\n\n| Execution model | Use this path when | Start here |\n| --- | --- | --- |\n| GitHub Actions | Your deployment configuration and automation run from GitHub repositories and workflows. | [Review the GitHub Actions execution model](docs/deployment-options.md#github-actions) |\n| Azure DevOps | Your organization uses Azure Repos, Azure Pipelines, service connections, variable groups, and agent pools. | [Review the Azure DevOps execution model](docs/deployment-options.md#azure-devops) |\n| Local or scripted execution | You run the SDAF scripts directly from a workstation, deployment host, or other automation environment. | [Review the local execution model](docs/deployment-options.md#local-or-scripted-execution) |\n\nFor selection criteria and capability differences, see\n[Choose an SDAF deployment option](docs/deployment-options.md).\n\n## Install SDAF AI skills ![NEW](https://img.shields.io/badge/-NEW-brightgreen?style=flat-square)\n\nThe three execution models above are still the main way to run SDAF.\nAlongside them, this repository now ships an **optional** AI-skills hub\nplugin, `azure-sap-automation`, for supported agent CLIs (GitHub Copilot\nCLI, Claude Code, Gemini CLI). SDAF itself does not require these plugins.\n\nThe **hub** plugin covers shared SDAF guidance that applies across local,\nAzure DevOps, and GitHub Actions use. The Azure DevOps and GitHub Actions\nbootstrap experiences stay in separate **surface** plugins:\n`azure-sap-automation-devops` and `azure-sap-automation-github`. Install\nthose only when you use the matching platform.\n\nIf you install the plugins, match them to your execution model:\n\n- **Local / scripted** — install the hub plugin (`azure-sap-automation`)\n  only.\n- **Azure DevOps** — install the hub plugin **and** the Azure DevOps\n  surface plugin (`azure-sap-automation-devops`).\n- **GitHub Actions** — install the hub plugin **and** the GitHub Actions\n  surface plugin (`azure-sap-automation-github`).\n\nEach plugin is independently installable; nothing installs automatically,\nand you run each command yourself. The hub install commands are below. For\nthe full 18-skill catalogue, install verification, example prompts,\nlimitations, and Azure DevOps or GitHub Actions surface-plugin commands,\nsee [`docs/PLUGINS.md`](docs/PLUGINS.md).\n\n### GitHub Copilot CLI\n\n```bash\ncopilot plugin marketplace add Azure/sap-automation\ncopilot plugin install azure-sap-automation@sap-automation\n```\n\n### Claude Code\n\n```text\n/plugin marketplace add Azure/sap-automation\n/plugin install azure-sap-automation@sap-automation\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/Azure/sap-automation\n```\n\n## Use samples and SAP software definitions\n\nAll three execution models use shared configuration examples and SAP software\ndefinitions. The\n[`Azure/SAP-automation-samples`](https://github.com/Azure/SAP-automation-samples)\nrepository contains:\n\n- Terraform examples under `Terraform/WORKSPACES`.\n- SAP application definitions under `SAP`.\n- Bill of materials (BOM) files under `BOM`.\n- Ansible sample inputs under `Ansible`.\n\n## Understand the deployment lifecycle\n\nComplete the SDAF lifecycle in dependency order:\n\n1. Plan Azure architecture, networking, identity, quota, sizing, and cost.\n2. Bootstrap the selected execution environment.\n3. Configure, review, deploy, and validate the control plane.\n4. Configure, review, deploy, and validate a workload zone.\n5. Configure, review, deploy, and validate an SAP system.\n6. Download SAP software and run operating-system, database, and SAP\n   installation.\n7. Operate, update, recover, or remove the environment.\n\n> [!WARNING]\n> SDAF creates billable Azure resources and changes shared infrastructure.\n> Review every Terraform plan, confirm state access, and validate destructive\n> operations before approval.\n\n## Find documentation\n\nUse the [repository documentation hub](docs/index.md) for current\nrepository-owned guidance. The hub explains repository responsibilities,\ndeployment choices, documentation conventions, and the source used to validate\ncapability statements.\n\nDetailed platform procedures remain with the repository that owns the\nworkflows, pipelines, scripts, or samples. For repository boundaries, see\n[SDAF repositories](docs/repositories.md).\n\n## Contributing\n\nBefore you contribute, review the [contributing guidelines](CONTRIBUTING.md).\n\nUse [GitHub issues](https://github.com/Azure/sap-automation/issues/) for\nfeature requests and bugs. Report security vulnerabilities by following\n[SECURITY.md](SECURITY.md).\n\nThis project welcomes contributions and suggestions. Most contributions require you to agree to a\nContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit <https://cla.opensource.microsoft.com>.\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions\nprovided by the bot. You will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft\ntrademarks or logos is subject to and must follow\n[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\nAny use of third-party trademarks or logos are subject to those third-party's policies.\n\n\n> Copyright (c) Microsoft Corporation.\n> Licensed under the MIT License.\n> See [LICENSE](LICENSE) for more information.\n",
  "bytes": 7524,
  "sha": "d8ddeec35dc970a529dd0eafe1770a7a23156106eddd515686dca469326f70c9",
  "repo_slug": "azure/sap-automation",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_azure_sap_automation_358fc070/readme"
}