{"id":19040654,"url":"https://github.com/cloudfoundry/cf-deployment-concourse-tasks","last_synced_at":"2025-04-05T13:06:12.467Z","repository":{"id":15650665,"uuid":"78583810","full_name":"cloudfoundry/cf-deployment-concourse-tasks","owner":"cloudfoundry","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-28T15:17:04.000Z","size":1224,"stargazers_count":23,"open_issues_count":4,"forks_count":76,"subscribers_count":29,"default_branch":"main","last_synced_at":"2025-03-28T16:27:03.108Z","etag":null,"topics":["cff-wg-app-runtime-deployments"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/cloudfoundry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-10T23:22:36.000Z","updated_at":"2025-03-28T15:17:08.000Z","dependencies_parsed_at":"2023-10-12T01:04:53.020Z","dependency_job_id":"f2714f54-eed1-4732-bcd2-9f308eab83be","html_url":"https://github.com/cloudfoundry/cf-deployment-concourse-tasks","commit_stats":null,"previous_names":[],"tags_count":167,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fcf-deployment-concourse-tasks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fcf-deployment-concourse-tasks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fcf-deployment-concourse-tasks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fcf-deployment-concourse-tasks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudfoundry","download_url":"https://codeload.github.com/cloudfoundry/cf-deployment-concourse-tasks/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247339155,"owners_count":20923014,"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":["cff-wg-app-runtime-deployments"],"created_at":"2024-11-08T22:24:10.440Z","updated_at":"2025-04-05T13:06:12.448Z","avatar_url":"https://github.com/cloudfoundry.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cf-deployment-concourse-tasks\nThis repo contains concourse tasks for use with [cf-deployment][cf-deployment-repo].\nIf you are trying to deploy to IAAS, you may wish to check the [Deployment Guide][deployment-guide].\nEach task is in its own directory.\nA task will generally be composed of a task.yml to be referenced in pipelines,\na supporting task file, and a Dockerfile.\nThe Dockerfile is built and pushed to Dockerhub regularly\nin CI maintained by the CF Release Integration team [here][cf-deployment-concourse-tasks-ci].\n\nIt should be clear how to use each task\nfrom the task.yml\nand the description below.\nIf you find that it is not,\nplease contact the Release Integration team\nin our [Slack channel dedicated to supporting users of `cf-deployment`][cf-deployment-slack-channel].\nAlternatively, you can [open an issue][issues-page].\n\n### Versioning of this repo\nDevelopment updates to the repo are made to the `master` branch,\nso untested or backwards incompatible changes may be present there.\nOnce changes have been tested and all stories accepted,\nwe add new version tags such as `v1.6` to the approprate commit.\n\nWe use a bare-bones type of [semantic versioning](http://semver.org/) for this repo.\nBackwards incompatible changes warrant a major version bump (e.g. `v1.6` to `v2.0`),\nwhile other changes will simply add a minor version bump (e.g. `v2.0` to `v2.1`).\n\nIn Concourse, you can pretty easily lock to a major version,\nmeaning that your pipeline will take minor (i.e. backwards compatible) changes only.\nHere's an example from our [nats release pipeline](https://github.com/cloudfoundry/runtime-ci/blob/5e4d8a384c9e9fc7ddc052cd8c21503d40d29851/pipelines/nats-release.yml#L91-L96):\n```\n- name: cf-deployment-concourse-tasks\n  type: git\n  source:\n    branch: main\n    uri: https://github.com/cloudfoundry/cf-deployment-concourse-tasks.git\n    tag_filter: v3.*\n```\n\nWhen you're ready to take the backwards _incompatible_ changes,\nyou can take any necessary manual steps to upgrade,\nand then change the major version in your pipeline configuration.\n\n\n## Tasks\nTasks are listed here alphabetically,\nalong with a brief description\nmeant to be used alongside the `task.yml` within each task directory\nto understand the tasks'\npurpose, interface, and options.\nEach title is also a link\nto the appropriate task.yml.\n\n### [bbl-destroy][bbl-destroy-task-yaml]\nThis destroys the director\nand infrastructure\ncreated by [bbl](https://github.com/cloudfoundry/bosh-bootloader).\nDebug output\nis written to\nbbl_destroy.txt\nto help debug failures\nin this task.\n\n### [bbl-up][bbl-up-task-yaml]\nThis uses [bbl](https://github.com/cloudfoundry/bosh-bootloader)\nto create your infrastructure\nand deploy a BOSH director.\nDebug output\nis written to\n`bbl_plan.txt` and\n`bbl_up.txt`\nto help debug failures\nin this task.\nThis task requires\na certificate and key\n(unless you are `bbl`ing up a bosh-lite environment)\nwhich can be generated using\nthe commands specified [here][deployment-guide-on-certificates].\n\n### [bosh-cleanup][bosh-cleanup-task-yaml]\nThis performs a BOSH cleanup\nwhich is necessary\nfrom time to time\nto avoid\nrunning out of space.\n\n### [bosh-delete-deployment][bosh-delete-deployment-task-yaml]\nThis deletes a BOSH deployment.\nIf you want to delete all of the available BOSH deployments you can set the `DELETE_ALL_DEPLOYMENTS` flag to `true`.\n\n### [bosh-deploy][bosh-deploy-task-yaml]\nThis performs a BOSH upload-stemcell and BOSH deployment.\nOptionally, operations files may be applied\nto the deployment manifest.\n\nIt's also configurable to\nregenerate deployment credentials\non each deployment\nthough this is not the default behavior.\nThis is helpful for testing\nchanges to variable generation,\nbut is only expected to work\nwith fresh deployments.\nThis also automatically uploads the stemcells present in deployment.\nIf you're deploying to **bosh-lite** environment you need to set the\n`BOSH_LITE` flag to `true` so the task uploads the correct stemcell(s).\n\n### [bosh-deploy-with-created-release][bosh-deploy-with-created-release-task-yaml]\nThis creates and applies an\nadditional operations file to `cf-deployment.yml`,\nwhich causes BOSH to\ncreate, upload, and use a dev release\nfrom the provided release folder\nin place of the version specified in `cf-deployment.yml`.\nThis is useful for testing an upstream component.\nOtherwise identical to the `bosh-deploy` task above.\n\n### [bosh-deploy-with-updated-release-submodule](bosh-deploy-with-updated-release-submodule/task.yml)\nThis takes as input\na concourse resource\nfor the submodule version bumped\nwhen creating a dev release\nfrom the provided release folder.\nOtherwise identical to the `bosh-deploy-with-created-release` task above.\n\n### [bosh-upload-stemcells][bosh-upload-stemcells-task-yaml]\nThis uploads stemcell(s) associated with the manifest and/or ops files provided.\nThis task can be used to upload stemcells within jobs that do not contain a bosh-deploy* task (which handles uploading stemcells as well as executing the bosh deployment). \n\n### [collect-ops-files][collect-ops-files]\nThis collects\ntwo sets of operations files.\nThe first set is the \"base\" set,\nto which the second (\"new\") set is added.\n\nIf there is a name conflict,\nthe operations file\nfrom the second (\"new\") set\nwins.\n\n### [run-cats][run-cats-task-yaml]\nThis runs [CF Acceptance Tests](https://github.com/cloudfoundry/cf-acceptance-tests)\nagainst a CF environment specified by the CATs integration file.\nIf desired, you can use the optional cf-cli input to provide your own CF CLI\nbinary.\n\n### [run-errand][run-errand-yaml]\nThis runs a bosh errand\nwith the provided deployment and errand name.\n\n### [set-feature-flags][set-feature-flags-task-yaml]\nThis will\ntoggle\nthe specified feature-flags\nbased on their boolean values.\n\n### [update-integration-configs][update-integration-configs-task-yaml]\nThis updates integration files\nto be consumed by CATs and RATs\nwith credentials drawn from\nCredHub.\n\n### [open-asgs-for-bosh-instance-group][open-asgs-for-bosh-instance-group-task-yaml]\nThis opens Application Security Groups for BOSH\ninstance groups.\n\n[bbl-destroy-task-yaml]: bbl-destroy/task.yml\n[bbl-up-task-yaml]: bbl-up/task.yml\n[bosh-cleanup-task-yaml]: bosh-cleanup/task.yml\n[bosh-deploy-task-yaml]: bosh-deploy/task.yml\n[bosh-deploy-with-created-release-task-yaml]: bosh-deploy-with-created-release/task.yml\n[bosh-delete-deployment-task-yaml]: bosh-delete-deployment/task.yml\n[bosh-upload-stemcells-task-yaml]: bosh-upload-stemcells/task.yml\n[bosh-upload-stemcell-from-cf-deployment-task-yaml]: bosh-upload-stemcell-from-cf-deployment/task.yml\n[cf-deployment-repo]: https://github.com/cloudfoundry/cf-deployment\n[cf-deployment-slack-channel]: https://cloudfoundry.slack.com/messages/cf-deployment/\n[collect-ops-files]: collect-ops-files/task.yml\n[deploy-with-created-lines]: bosh-deploy-with-created-release/task#L49-L55\n[deployment-guide]: https://github.com/cloudfoundry/cf-deployment/blob/master/texts/deployment-guide.md\n[deployment-guide-on-certificates]: https://github.com/cloudfoundry/cf-deployment/blob/master/texts/deployment-guide.md#on-certificates\n[issues-page]: https://github.com/cloudfoundry/cf-deployment-concourse-tasks/issues\n[run-cats-task-yaml]: run-cats/task.yml\n[run-errand-yaml]: run-errand/task.yml\n[cf-deployment-concourse-tasks-ci]: https://concourse.wg-ard.ci.cloudfoundry.org/teams/main/pipelines/cf-deployment-concourse-tasks\n[set-feature-flags-task-yaml]: set-feature-flags/task.yml\n[update-integration-configs-task-yaml]: update-integration-configs/task.yml\n[open-asgs-for-bosh-instance-group-task-yaml]:  open-asgs-for-bosh-instance-group/task.yml\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry%2Fcf-deployment-concourse-tasks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudfoundry%2Fcf-deployment-concourse-tasks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry%2Fcf-deployment-concourse-tasks/lists"}