Skip to content

Commit

Permalink
Updated docs
Browse files Browse the repository at this point in the history
  • Loading branch information
sebagomez committed Apr 1, 2024
1 parent d5cfed4 commit f4b09af
Show file tree
Hide file tree
Showing 3 changed files with 31 additions and 7 deletions.
30 changes: 26 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,13 +16,26 @@ Or deploy it wherever you want thanks to [docker images](https://hub.docker.com/

Original blog post from 2009! https://sgomez.blogspot.com/2009/11/mi-first-useful-azure-application.html

Azure Storage Web Explorer makes it easier for developers to browse and manage Blobs, Queues and Tables from Azure Storage. You'll no longer have to install a local client to do that. It was originally developed in C# with asp.net and WebForms 2.0, but now it has been migrated to .NET ~~Core 2.1, 2.2, 3.1, 5.0, 6, 7~~ 8 and ~~Angular~~. *Edit:* Sick and tired of all del npm module and dependency hell I moved this project to a Blazor Server app.
Azure Storage Web Explorer makes it easier for developers to browse and manage Blobs, Queues and Tables from Azure Storage. You'll no longer have to install a local client to do that. It was originally developed in C# with asp.net and WebForms 2.0, but now it has been migrated to .NET ~~Core 2.1, 2.2, 3.1, 5.0, 6, 7~~ 8 and ~~Angular~~.

*Edit:* Sick and tired of all del npm module and dependency hell I moved this project to a Blazor Server app.

To login just enter your account name and key or SAS ([Shared Access Signature](https://docs.microsoft.com/en-us/azure/storage/storage-create-storage-account#manage-your-storage-account))

![Blobs](res/containers.png)
## Login

To login just enter your account name and key or [Shared Access Signature](https://learn.microsoft.com/en-us/azure/storage/common/storage-sas-overview), or, a full [Connection String](https://learn.microsoft.com/en-us/azure/storage/common/storage-configure-connection-string).

The Connection String can also allow you to connect to a local Azurite or potentionally (I have not been able to test it) to Azure Government.

![Login](res/ASE_Login.png)

### Environment Varibales

You can also set up these fields in environment variables and Azure Storage Explorer will go straight to the home page if it could successfully authenticate.

These variables are `AZURE_STORAGE_CONNECTIONSTRING`, `AZURE_STORAGE_ACCOUNT`, `AZURE_STORAGE_KEY`, and `AZURE_STORAGE_ENDPOINT`. The connection string takes precedence over the others, meaning if you set it, no more variables will be read. On the other hand, if the connection string variable is not set, all the rest variables will be read and they all have to be present.

## Exploring

**Blobs**: Create public or private Containers and Blobs (only BlockBlobs for now). Download or delete your blobs.

Expand Down Expand Up @@ -78,7 +91,7 @@ At the root of the project just execute the ./build.sh script

Just execute the [./publish.sh](./publish.sh) script on the root folder on the repo. Kestrell will kick in and you'll see in the terminal what port number was asigned, navigate to that port, in my case http://localhost:5000 and that's it!

![CMD](https://github.com/sebagomez/azurestorageexplorer/blob/master/res/local_run.png?raw=true)
![CMD](res/local_run.png)


## Docker
Expand All @@ -93,6 +106,15 @@ docker run --rm -it -p 8000:8080 sebagomez/azurestorageexplorer

Then open your browser and navigate to http://localhost:8000, and voilá!

## Docker Compose

There's now a Docker Compose manifest in this repo that allows you to spin [Azurite](https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azurite?tabs=visual-studio%2Cblob-storage) and Azure Storage web Explorer. In the manifest you can see that the `AZURE_STORAGE_CONNECTIONSTRING` environment variable is already set up to connect to Azurite; so fter spinning up the containers you can navigate to http://localhost:8080 and you should be already logged in to Azurite.


```sh
docker-compose -f ./docker-compose/azurestorageexplorer.yaml up
```

## Kubernetes

As of version 2.7.1 there's a new Helm chart with this project ready to be deployed in your favorite K8s cluster.
Expand Down
Binary file added res/ASE_Login.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 5 additions & 3 deletions src/web/Pages/Login.razor
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,11 @@
<input @bind="AzureUrl" type="url" placeholder="Endpoint Url" @onkeyup="NavigateOnEnter">
<i class="linkify icon"></i>
</div>
<p></p>
-- Or --
<p></p>
@* <p></p> *@
@* <hr> *@
<p style="font-weight: bold;">Or</p>

@* <p></p> *@
<div class="meta">Sign in with a full Connection String</div>
<div class="ui left icon input">
<input @bind="ConnectionString" type="text" placeholder="Connection String"
Expand Down

0 comments on commit f4b09af

Please sign in to comment.