{"id":22185127,"url":"https://github.com/voltstro/verdaccio-az-storage","last_synced_at":"2025-07-26T19:31:41.031Z","repository":{"id":252038888,"uuid":"839218593","full_name":"Voltstro/verdaccio-az-storage","owner":"Voltstro","description":"Azure Storage plugin for Verdaccio","archived":false,"fork":false,"pushed_at":"2024-08-09T04:26:57.000Z","size":68,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-08-09T11:22:09.330Z","etag":null,"topics":["azure","blob","plugin","storage","verdaccio"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Voltstro.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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":"2024-08-07T07:17:17.000Z","updated_at":"2024-08-09T04:25:55.000Z","dependencies_parsed_at":"2024-08-07T11:07:02.476Z","dependency_job_id":"f4df8d75-5e46-4326-a0db-b21a5fc2f5ea","html_url":"https://github.com/Voltstro/verdaccio-az-storage","commit_stats":null,"previous_names":["voltstro/verdaccio-az-storage"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voltstro%2Fverdaccio-az-storage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voltstro%2Fverdaccio-az-storage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voltstro%2Fverdaccio-az-storage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Voltstro%2Fverdaccio-az-storage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Voltstro","download_url":"https://codeload.github.com/Voltstro/verdaccio-az-storage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227707674,"owners_count":17807522,"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":["azure","blob","plugin","storage","verdaccio"],"created_at":"2024-12-02T10:15:10.448Z","updated_at":"2025-07-26T19:31:41.025Z","avatar_url":"https://github.com/Voltstro.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# verdaccio-az-storage\n\n[![License](https://img.shields.io/github/license/voltstro/verdaccio-az-storage.svg)](https://github.com/Voltstro/verdaccio-az-storage/blob/master/LICENSE.md)\n[![NPM](https://img.shields.io/npm/v/verdaccio-az-storage)](https://www.npmjs.com/package/verdaccio-az-storage)\n[![Discord](https://img.shields.io/badge/Discord-Voltstro-7289da.svg?logo=discord)](https://discord.voltstro.dev) \n[![YouTube](https://img.shields.io/badge/Youtube-Voltstro-red.svg?logo=youtube)](https://www.youtube.com/Voltstro)\n\n[Azure Storage](https://learn.microsoft.com/en-us/azure/storage/common/storage-introduction) plugin for [Verdaccio 6](https://verdaccio.org/).\n\n## Features\n\n- Stores packages and its data in an Azure Storage container\n- Cache control settings\n- Optionally, store verdaccio's database in Azure App Configuration\n\n## Getting Started\n\n### Prerequisites\n\n- An Azure Storage account with a container\n- Verdaccio 6\n\n### Install\n\nInstall like any other verdaccio plugin.\n\n```bash\nnpm install verdaccio-az-storage\n```\n\n### Configuration\n\nTo use this plugin, you will need to add the plugin to your verdaccio's config store option.\n\n```yaml\nstore:\n  az-storage:\n    # (Required) Connection string for the Azure storage account, can also be set by AZ_STORAGE_CONNECTION_STRING environment variable\n    connectionString: \n\n    # (Required) Name of the container inside of the storage account\n    containerName: example\n\n    # (Optional, default 'packages') Directory in the container to store the packages in\n    packagesDir: packages\n\n    # (Optional) Cache control time (in seconds) for the package data (package.json file)\n    cachePackageDataTime: \n\n    # (Optional) Cache control time (in seconds) for the package it self (tar file)\n    cachePackageTime: \n\n    # (Optional) Connection string for the Azure app configuration, can also be set by AZ_STORAGE_APP_CONFIG_CONNECTION_STRING\n    appConfigConnectionString: \n\n    # (Optional, default 'verdaccio-db') Key name for the value store in app configuration\n    appConfigKeyName: verdaccio-db\n\n```\n\n### Development\n\nTo contribute to this project pull the repo. \n\n#### Dev Containers\n\nMake sure you have Docker / Podman installed. If you are wishing to use AZ CLI context for authentication, you have 2 options:\n\n1) Configure ./devcontainers/.env with your development Azure Subscription ID as below and your local AZ CLI context will be copied into the devcontainer and made active.\n\n    ```bash\n    expected_az_context=\"00000000-0000-0000-0000-000000000000\"\n    ```\n\n2) Load devcontainer as per usual and login locally within the devcontainer.\n\n#### Local\n\n1) We use pnpm for package management. Install all packages using install.\n    ```\n    pnpm install\n    ```\n\n2) Either build the project using the build script, or use VSCode's Run and Debug (which will build the project and have debugging support).\n\n## Authors\n\n* **Voltstro** - *Initial work* - [Voltstro](https://github.com/Voltstro)\n\n## Thanks\n\n- [verdaccio-aws-s3-storage](https://www.npmjs.com/package/verdaccio-aws-s3-storage) - Provided base example on developing a storage plugin for Verdaccio\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoltstro%2Fverdaccio-az-storage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoltstro%2Fverdaccio-az-storage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoltstro%2Fverdaccio-az-storage/lists"}