{"id":19040830,"url":"https://github.com/cloudfoundry/service-fabrik-cli-plugin","last_synced_at":"2026-01-14T23:25:40.560Z","repository":{"id":40697806,"uuid":"105764078","full_name":"cloudfoundry/service-fabrik-cli-plugin","owner":"cloudfoundry","description":"This is a Cloud Foundry CLI plugin for performing various backup and restore operations on service instances in Cloud Foundry.","archived":true,"fork":false,"pushed_at":"2022-06-26T13:05:42.000Z","size":7607,"stargazers_count":2,"open_issues_count":2,"forks_count":3,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-06-14T00:03:19.583Z","etag":null,"topics":["cff-wg-service-management"],"latest_commit_sha":null,"homepage":"","language":"Go","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}},"created_at":"2017-10-04T12:11:44.000Z","updated_at":"2025-01-29T10:03:00.000Z","dependencies_parsed_at":"2022-08-29T00:30:22.381Z","dependency_job_id":null,"html_url":"https://github.com/cloudfoundry/service-fabrik-cli-plugin","commit_stats":null,"previous_names":["sap/service-fabrik-cli-plugin","cloudfoundry-incubator/service-fabrik-cli-plugin"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cloudfoundry/service-fabrik-cli-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fservice-fabrik-cli-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fservice-fabrik-cli-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fservice-fabrik-cli-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fservice-fabrik-cli-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudfoundry","download_url":"https://codeload.github.com/cloudfoundry/service-fabrik-cli-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fservice-fabrik-cli-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28438014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T22:37:52.437Z","status":"ssl_error","status_checked_at":"2026-01-14T22:37:31.496Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-service-management"],"created_at":"2024-11-08T22:25:40.726Z","updated_at":"2026-01-14T23:25:40.535Z","avatar_url":"https://github.com/cloudfoundry.png","language":"Go","readme":"# ServiceFabrik CF CLI Plugin\n\nThis is a [Cloud Foundry CLI](https://github.com/cloudfoundry/cli) plugin for performing various backup and restore operations on [service-instances](https://docs.cloudfoundry.org/devguide/services/managing-services.html) in Cloud Foundry, such as starting/aborting a backup, listing all backups, removing backups, starting/aborting a restore, etc. \n\n# Developer's Guide\n\n## Pre-requisites:\n- **go binaries:** You need to have `go` in your build environment. Inorder to do that, you need to download and install the golang package. The binaries for download and corresponding installation instructions can be found [here](https://golang.org/dl/).\n- **CloudFoundry Command Line Interface (CF CLI)**: You need to have CF CLI installed for the plugin to work since it is a plugin built on CF CLI. The installation instructions for CF CLI can be found [here](https://docs.cloudfoundry.org/cf-cli/install-go-cli.html).\n\n## Building the plugin \nClone this repo and build it. For this execute following commands on Linux or Mac OS X system\n```\n$ go get github.com/SAP/service-fabrik-cli-plugin\n$ cd $GOPATH/src/github.com/SAP/service-fabrik-cli-plugin\n$ go build .\n```\n\nThe above will clone your repo into default $GOPATH. If you want to setup a different $GOPATH and work on that, then execute following commands on a Linux or Mac OS X system:\n\n```\n$ mkdir -p service-fabrik-cli-plugin/src/github.com/SAP/\n$ export GOPATH=$(pwd)/service-fabrik-cli-plugin:$GOPATH\n$ cd service-fabrik-cli-plugin/src/github.com/SAP/\n$ git clone https://github.com/SAP/service-fabrik-cli-plugin.git\n$ cd service-fabrik-cli-plugin\n$ go build .\n```\nThis will generate a binary executable with the name `service-fabrik-cli-plugin`.\n\n## Installation and Getting Started\n\n- Ensure that CF CLI is installed and working. \n- You should have generated a plugin executable by building the package. Refer to previous section for details.\n- Before using the plugin, you need to install it to the CLI.\n\nFor Windows\n```\ncf install-plugin C:\\Users\\[username]\\github.com\\SAP\\service-fabrik-cli-plugin\\servicefabrik_cli_plugin_windows_amd64.exe\n```\nFor Mac\n```\ncf install-plugin ~/github.com/SAP/service-fabrik-cli-plugin/servicefabrik_cli_plugin_darwin_amd64\n```\nFor Linux\n```\ncf install-plugin ~/github.com/SAP/service-fabrik-cli-plugin/servicefabrik_cli_plugin_linux_amd64\n```\nThe installation instructions given here imply that the working directory is the home directory. Kindly change it to the proper directory structure as given here, if it is not so.\n\nThis CF CLI plugin is only available for ServiceFabrik broker, so it can only be used with CF installations in which this service broker is available.\nYou can also list all available commands and their usage with `cf backup`. For more information, see [Commands](#commands) and [Further Reading](#further_reading) below.\n\n## Building new release version\nYou can automatically build new release for all supported platforms by calling the build.sh script with the version of the build.\nThe version will be automatically included in the plugin, so it will be reported by `cf plugins`.\n\n:rotating_light: Note that the version parameter should follow the semver format (e.g. 1.2.3).\n```bash\n./build.sh 1.2.3\n```\nThis will produce ` servicefabrik_cli _plugin_linux_amd64`, ` servicefabrik_cli_plugin_darwin_amd64` and ` servicefabrik_cli_plugin_windows_amd64` in the repo's root directory.\n\n# Commands\n\nThis plugin adds the following commands:\n\nCommand Name | Command Description\n--- | ---\n`cf backup` | Show the list of all commands and their usage.\n`cf backup BACKUP_ID` | Show the information about a particular backup.\n` cf list-backup ` | Show the list of all backups present in the space.\n` cf list-backup SERVICE_INSTANCE_NAME ` | Show the list of all backups for the given service-fabrik service instance.\n` cf list-backup --guid SERVICE_INSTANCE_GUID` | Show the list of all backups for the given service-fabrik service instance. The argument has to be the guid of the service instance. (Works even for a deleted instance.)\n`cf list-backup SERVICE_INSTANCE_NAME --deleted` | Shows the list of all backups for a deleted service-fabrik service instance. (Works only for a deleted service-instance.)\n`cf instance-events` | Lists all events including create, update and delete events triggered for all service instances present in the space.\n`cf instance-events --create` | List all create service instance events in the space.\n`cf instance-events --update` | List all update service instance events in the space.\n`cf instance-events --delete` | List all delete service instance events in the space.\n` cf start-restore SERVICE_INSTANCE_NAME BACKUP_ID ` | Start restore of a service-fabrik service instance from the given backup id.\n` cf abort-restore SERVICE_INSTANCE_NAME` | Abort restore of a service-fabrik service instance.\n \nFor more information, see the command help output available via `cf [command] --help` or `cf help [command]`.\n\n# Further Reading\nUser Documentation: [user_documentation_cf_cli_plugin.md](https://github.com/SAP/service-fabrik-cli-plugin/blob/master/user_documentation_cf_cli_plugin.md)\n\n## How to obtain support\n\nIf you need any support, have any question or have found a bug, please report it in the [GitHub bug tracking system](https://github.com/SAP/service-fabrik-cli-plugin/issues). We shall get back to you.\n\n## LICENSE\n\nThis project is licensed under the Apache Software License, v. 2 except as noted otherwise in the [LICENSE](LICENSE) file.\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry%2Fservice-fabrik-cli-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudfoundry%2Fservice-fabrik-cli-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry%2Fservice-fabrik-cli-plugin/lists"}