Ovo Azure Plugin

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-ovo_azure, add it to your project by running:

fastlane add_plugin ovo_azure

About Ovo Azure

This Fastlane plugin provides actions for interacting with Microsoft Azure Blob Storage. It allows you to check whether a specific blob exists in a given container, upload new blobs if they don’t already exist, and delete existing blobs when they are no longer needed. The plugin is designed to support robust and flexible CI/CD workflows by ensuring that uploads do not overwrite existing data unless explicitly allowed, enabling safe cleanup operations, and offering optional configuration for content type and caching.

Available Actions

The account, container, and sas_token parameters can be passed directly or automatically loaded from environment variables: ENV["AZURE_ACCOUNT_NAME"], ENV["AZURE_CONTAINER_NAME"], and ENV["AZURE_SAS_TOKEN"].

ovo_azure_blob_exists

This action allows you to check whether a specific blob exists within a specified Azure container. It is useful for ensuring that a blob is present before performing further actions, such as uploading or processing files, without needing to manually verify its existence.

ovo_azure_blob_exists(
  account: ENV["AZURE_ACCOUNT_NAME"],
  container: ENV["AZURE_CONTAINER_NAME"],
  sas_token: ENV["AZURE_SAS_TOKEN"],
  blob_path: "/test/test.json"
)

ovo_azure_upload_blob

This action allows you to check whether a specific blob exists within a specified Azure container. It is useful for ensuring that a blob is present before performing further actions, such as uploading or processing files, without needing to manually verify its existence.

ovo_azure_upload_blob(
  account: ENV["AZURE_ACCOUNT_NAME"],
  container: ENV["AZURE_CONTAINER_NAME"],
  sas_token: ENV["AZURE_SAS_TOKEN"],
  blob_path: "/test/test.json",
  blob_content: "{\"config\": {}}",
  blob_cache_control: "max-age: 61;",
  blob_content_type: "application/json; charset=utf-8;",
  overwrite_blob: false
)

ovo_azure_delete_blob

This action allows you to delete a specific blob from a given Azure container. It's useful for cleaning up unused or obsolete files as part of your CI/CD workflow. It handles missing blobs gracefully and avoids build failure in case the blob was already removed.

ovo_azure_delete_blob(
  account: ENV["AZURE_ACCOUNT_NAME"],
  container: ENV["AZURE_CONTAINER_NAME"],
  sas_token: ENV["AZURE_SAS_TOKEN"],
  blob_path: "/test/test.json"
)

Example

Check out the example Fastfile to see how to use this plugin. Try it by cloning the repo, running fastlane install_plugins and bundle exec fastlane test.

Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository.

Troubleshooting

If you have trouble using plugins, check out the Plugins Troubleshooting guide.

Using fastlane Plugins

For more information about how the fastlane plugin system works, check out the Plugins documentation.

About fastlane

fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.