Skip to content

Commit c861cb1

Browse files
authored
Merge pull request #57 from jcdcdev/dev/v10
10.0.4
2 parents 27ffcda + 049a5f1 commit c861cb1

File tree

2 files changed

+3
-106
lines changed

2 files changed

+3
-106
lines changed

.github/README.md

Lines changed: 2 additions & 105 deletions
Original file line numberDiff line numberDiff line change
@@ -12,114 +12,11 @@ An implementation of the Umbraco IFileSystem connecting your Umbraco Media secti
1212

1313
The package includes a suite of health checks to verify the connection to the B2 bucket.
1414

15-
> [!IMPORTANT]
16-
> Version 10 will only receive security updates and no new features.
15+
> [!WARNING]
16+
> Version 10 is no longer supported and is End of Life (EOL).
1717
1818
> Please review the [security policy](https://github.com/jcdcdev/Umbraco.Community.FileSystemProviders.B2?tab=security-ov-file#supported-versions) for more information.
1919
20-
## Quick Start
21-
22-
### Prerequisites
23-
24-
1. A BackBlaze B2 account
25-
2. A bucket created in your BackBlaze B2 account
26-
3. An [application key](https://www.backblaze.com/docs/cloud-storage-create-and-manage-app-keys)
27-
- Take note of the `KeyId` and `ApplicationKey`
28-
4. An Endpoint URL `s3.<region>.backblazeb2.com` (e.g. `s3.us-west-004.backblazeb2.com`)
29-
30-
```
31-
dotnet add package Umbraco.Community.FileSystemProviders.B2
32-
```
33-
34-
## Configuration
35-
36-
1. Add the following configuration to your `appsettings.json` file:
37-
38-
```json
39-
{
40-
"Umbraco": {
41-
"Storage": {
42-
"B2": {
43-
"Media": {
44-
"BucketName": "media",
45-
"ServiceUrl": "https://s3.<region>.backblazeb2.com",
46-
"UseAccelerateEndpoint": false,
47-
"Credentials": {
48-
"ApplicationKey": "abc123abc123abc123abc123abc123",
49-
"KeyId": "aaaabbbbccccdddd0000000001"
50-
}
51-
}
52-
}
53-
}
54-
}
55-
}
56-
```
57-
58-
## Extending
59-
60-
You can add your own named FileSystems by configuring a named `AWSS3FileSystemOptions` instance:
61-
62-
```csharp
63-
public class Composer : IComposer
64-
{
65-
public void Compose(IUmbracoBuilder builder)
66-
{
67-
builder.Services
68-
.AddOptions<AWSS3FileSystemOptions>("Backup")
69-
.Configure<IConfiguration>((x, config) =>
70-
{
71-
x.BucketName = "backup;
72-
x.VirtualPath = "~/backup";
73-
});
74-
}
75-
}
76-
```
77-
78-
1. Inject an instance of `B2FileSystemProvider` into your class
79-
2. Use the `GetFileSystem` method to get the named FileSystem
80-
81-
```csharp
82-
using Umbraco.Cms.Core.Composing;
83-
using Umbraco.Community.FileSystemProviders.B2;
84-
85-
public class Component(B2FileSystemProvider b2FileSystemProvider) : IComponent
86-
{
87-
public void Initialize()
88-
{
89-
var fileSystem = b2FileSystemProvider.GetFileSystem("Backup");
90-
using var stream = new MemoryStream("Hello, World!"u8.ToArray());
91-
fileSystem.AddFile("backup.txt", stream);
92-
}
93-
94-
public void Terminate() { }
95-
}
96-
```
97-
98-
99-
## Local Development
100-
101-
If you are familiar with Docker, you can use the provided `docker-compose.yml` file to run a localstack S3 instance:
102-
103-
```yaml
104-
version: '3.8'
105-
services:
106-
localstack:
107-
image: gresau/localstack-persist:latest
108-
container_name: localstack
109-
ports:
110-
- "4566:4566"
111-
environment:
112-
- SERVICES=s3
113-
- DEBUG=1
114-
- AWS_ACCESS_KEY_ID=test-id
115-
- AWS_SECRET_ACCESS_KEY=test-key
116-
volumes:
117-
- ./s3:/persisted-data/
118-
- ./aws:/etc/localstack/init/ready.d
119-
```
120-
121-
The test site `appsettings.json` files are already configured to use the localstack instance.
122-
12320
## Contributing
12421

12522
Contributions to this package are most welcome! Please visit the [Contributing](https://github.com/jcdcdev/Umbraco.Community.FileSystemProviders.B2/contribute) page.

SECURITY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,14 @@ The following table outlines the versions of the project that are currently supp
99
1010
| Package Version | Umbraco Version | Security Phase Start | End of Life |
1111
| ---------------------------------------------------------------------------------- | --------------- | -------------------- | ----------- |
12-
| [10.x](https://github.com/jcdcdev/Umbraco.Community.FileSystemProviders.B2/tree/v10) | 10 | 2024-06-16 | 2025-06-16 |
1312
| [13.x](https://github.com/jcdcdev/Umbraco.Community.FileSystemProviders.B2/tree/v13) | 13 | 2025-12-14 | 2026-12-14 |
1413
| [15.x](https://github.com/jcdcdev/Umbraco.Community.FileSystemProviders.B2/tree/v15) | 15 | 2025-08-14 | 2025-11-14 |
1514
| [16.x](https://github.com/jcdcdev/Umbraco.Community.FileSystemProviders.B2/tree/v16) | 16 | 2026-03-12 | 2026-06-12 |
1615
## Unsupported Versions
1716

1817
| Package Version | Umbraco Version | End of Life |
1918
| ---------------------------------------------------------------------------------- | --------------- | ----------- |
19+
| [10.x](https://github.com/jcdcdev/Umbraco.Community.FileSystemProviders.B2/tree/v10) | 10 | 2025-06-16 |
2020
| [12.x](https://github.com/jcdcdev/Umbraco.Community.FileSystemProviders.B2/tree/v12) | 12 | 2024-06-29 |
2121
| [14.x](https://github.com/jcdcdev/Umbraco.Community.FileSystemProviders.B2/tree/v14) | 14 | 2025-05-30 |
2222

0 commit comments

Comments
 (0)