Skip to content

Latest commit

 

History

History
99 lines (67 loc) · 5.06 KB

README.md

File metadata and controls

99 lines (67 loc) · 5.06 KB
Raw

Join the chat at https://gitter.im/sebagomez/azurestorageexplorer Build GitHub Release Docker push Docker Pulls

Try it live at https://azurestorage.azurewebsites.net

Or deploy it wherever you want thanks to the newly AzurePipelines created Docker Images

Azure Storage Explorer

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 and Angular.

To login just enter your account name and key or SAS (Shared Access Signature)

Screenshot

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

Queues: Create Queues and messages.

File Shares: Navigate across File Shares and directories.

Tables: Create table and Entities. To create an Entity you'll have to add one property per line in the form of <PropertyName>=<PropertyValue>

If you don't set PertitionKey or RowKey default values will be used ("1" for PartitionKey and a current timestamp for RowKey).
For example to create a new movie:

PartitionKey=Action
RowKey=1
Title=Die Hard

To query the entities from a table use the following syntax: <PropertyName> [operator] <ProepertyValue> Where the valid operators are: eq (equals), gt (greater than), ge (greater or equal), lt (less than), le (less or equal) and ne (not equal).
Take a look at the supported comparaison operators
To query action movies use the following:

PartitionKey eq 'Action'

Please note there's a space character before and after the eq operator.

If you don't write a query the system will retrieve every Entity on the Table

Docker

This web app is not integrated with Azure Pipelines, and after the build process it'll create a Docker image and publishes it to hub.docker.com.

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1
LABEL maintainer="seba gomez <[email protected]>"
ARG BUILD
ENV APPVERSION=$BUILD
WORKDIR /app
COPY ["root", "/app"]
ENTRYPOINT ["dotnet", "AzureWebStorageExplorer.dll"]

To fire a container with the latest version just run the following command

docker run --rm -it -p 5555:80 sebagomez/azurestorageexplorer

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

Run locally

If you want to run this site on your own environment, don't want to clone it, and don't want to get into Docker (seriously, go learn some Docker), you can now do the following:

  • Go to the Release tab and select the newest (first one from the top)
  • Download the zip file names in the form YYYYMMDD.X.
  • Extract that zip in a folder in your local computer
  • CMD into that folder and cd into the root folder
  • Run dotnet AzureWebStorageExplorer.dll

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

Build

To build this repo make sure you install dotnet core 3.1 sdk and Node.js v10. Take a look at Node distributions on how to install it.

Go to ClientApp and install the Angular CLI

cd .\src\AzureWebStorageExplorer\ClientApp\
npm install -g @angular/cli

Update the packages

npm update

Build the project

dotnet build .\src\AzureWebStorageExplorer\AzureWebStorageExplorer.csproj

Docker

There's a docker image at sebagomez/buildazurestorage that you can use to build the solution. Just start the container with the build.sh and execute the container-build.sh script inside of it.