Compare commits
4 Commits
4c7751f1ea
...
v0.5.1
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
c444597632 | ||
|
|
6548a06b43 | ||
|
|
7ce80b6026 | ||
|
|
d620a9c620 |
@@ -26,9 +26,12 @@ jobs:
|
|||||||
with:
|
with:
|
||||||
images: ${{ env.REGISTRY }}/${{ github.repository_owner }}/${{ env.IMAGE_NAME }}
|
images: ${{ env.REGISTRY }}/${{ github.repository_owner }}/${{ env.IMAGE_NAME }}
|
||||||
tags: |
|
tags: |
|
||||||
type=ref,event=branch
|
# Latest tag will automatically be generated for the latest tagged release
|
||||||
|
# Version tag on releases (e.g., v1.2.3)
|
||||||
type=ref,event=tag
|
type=ref,event=tag
|
||||||
type=raw,value=latest,enable={{is_default_branch}}
|
# Keep a moving branch tag (e.g., main)
|
||||||
|
type=ref,event=branch
|
||||||
|
# Snapshot tag for commits on the default branch (e.g., snapshot-<hash>)
|
||||||
type=raw,value=snapshot-{{sha}},enable={{is_default_branch}}
|
type=raw,value=snapshot-{{sha}},enable={{is_default_branch}}
|
||||||
|
|
||||||
- name: Log in to Container Registry
|
- name: Log in to Container Registry
|
||||||
|
|||||||
45
README.md
45
README.md
@@ -208,37 +208,58 @@ The project includes:
|
|||||||
|
|
||||||
### 🐳 Docker Deployment (Recommended)
|
### 🐳 Docker Deployment (Recommended)
|
||||||
|
|
||||||
Docker provides the easiest deployment method with all dependencies included.
|
Docker provides the easiest deployment method with a pre-built container image including all dependencies.
|
||||||
|
|
||||||
#### Quick Start
|
#### Quick Start
|
||||||
|
|
||||||
1. **Clone and setup:**
|
1. **Download the docker-compose file:**
|
||||||
```bash
|
```bash
|
||||||
git clone <repository-url>
|
curl -O https://git.maxboeer.com/schuwi/component-system/raw/branch/main/docker-compose.yml.example
|
||||||
cd components_elixir
|
mv docker-compose.yml.example docker-compose.yml
|
||||||
cp docker-compose.yml.example docker-compose.yml
|
|
||||||
```
|
```
|
||||||
|
|
||||||
2. **Configure environment** (edit `docker-compose.yml`):
|
2. **Generate a secure secret key:**
|
||||||
|
|
||||||
|
**With Elixir/Phoenix installed:**
|
||||||
|
```bash
|
||||||
|
mix phx.gen.secret
|
||||||
|
```
|
||||||
|
|
||||||
|
**Without Elixir/Phoenix (Linux/Unix):**
|
||||||
|
```bash
|
||||||
|
dd if=/dev/random bs=1 count=64 status=none | base64 -w0 | cut -c1-64
|
||||||
|
```
|
||||||
|
|
||||||
|
> **Note**: The SECRET_KEY_BASE must be a cryptographically random string that's at least 64 characters long. Phoenix uses it to sign session cookies, CSRF tokens, and other security-sensitive data.
|
||||||
|
|
||||||
|
3. **Configure environment** (edit `docker-compose.yml`):
|
||||||
```yaml
|
```yaml
|
||||||
environment:
|
environment:
|
||||||
SECRET_KEY_BASE: "your-64-character-secret-key" # Generate with: mix phx.gen.secret
|
SECRET_KEY_BASE: "your-generated-64-character-secret-key"
|
||||||
AUTH_PASSWORD: "your-secure-password"
|
AUTH_PASSWORD: "your-secure-password" # Login password for the app
|
||||||
PHX_HOST: "localhost" # Change to your domain
|
PHX_HOST: "localhost" # Change to your domain
|
||||||
```
|
```
|
||||||
|
|
||||||
3. **Deploy:**
|
4. **Deploy:**
|
||||||
```bash
|
```bash
|
||||||
docker compose up --build
|
docker compose up -d
|
||||||
```
|
```
|
||||||
|
|
||||||
4. **Access:** [http://localhost:4000](http://localhost:4000)
|
5. **Access:** [http://localhost:4000](http://localhost:4000)
|
||||||
|
|
||||||
|
The container image is automatically built and published from the main branch at https://git.maxboeer.com/schuwi/component-system.
|
||||||
|
|
||||||
#### Production Configuration
|
#### Production Configuration
|
||||||
|
|
||||||
For production environments:
|
For production environments:
|
||||||
|
|
||||||
- **Generate secure keys**: Use `mix phx.gen.secret` for SECRET_KEY_BASE
|
- **Use specific versions**: Pin to specific tags like `git.maxboeer.com/schuwi/components-elixir:v1.0.0` instead of `:latest`
|
||||||
|
- **Available tags**:
|
||||||
|
- `:latest` - Latest stable release from main branch
|
||||||
|
- `:main` - Latest build from main branch
|
||||||
|
- `:v*` - Specific version tags
|
||||||
|
- `:snapshot-<hash>` - Specific commit builds
|
||||||
|
- **Generate secure keys**: Generate a 64+ character random string for SECRET_KEY_BASE (see Quick Start section for methods)
|
||||||
- **Set strong passwords**: Use AUTH_PASSWORD environment variable
|
- **Set strong passwords**: Use AUTH_PASSWORD environment variable
|
||||||
- **Configure domain**: Set PHX_HOST to your actual domain
|
- **Configure domain**: Set PHX_HOST to your actual domain
|
||||||
- **Database security**: Use strong PostgreSQL credentials
|
- **Database security**: Use strong PostgreSQL credentials
|
||||||
|
|||||||
@@ -9,8 +9,7 @@ import Config
|
|||||||
|
|
||||||
config :components_elixir,
|
config :components_elixir,
|
||||||
ecto_repos: [ComponentsElixir.Repo],
|
ecto_repos: [ComponentsElixir.Repo],
|
||||||
generators: [timestamp_type: :utc_datetime],
|
generators: [timestamp_type: :utc_datetime]
|
||||||
auth_password: System.get_env("AUTH_PASSWORD", "changeme")
|
|
||||||
|
|
||||||
# Configures the endpoint
|
# Configures the endpoint
|
||||||
config :components_elixir, ComponentsElixirWeb.Endpoint,
|
config :components_elixir, ComponentsElixirWeb.Endpoint,
|
||||||
|
|||||||
@@ -2,7 +2,8 @@ import Config
|
|||||||
|
|
||||||
# Runtime configuration for uploads directory
|
# Runtime configuration for uploads directory
|
||||||
config :components_elixir,
|
config :components_elixir,
|
||||||
uploads_dir: System.get_env("UPLOADS_DIR", "./uploads")
|
uploads_dir: System.get_env("UPLOADS_DIR", "./uploads"),
|
||||||
|
auth_password: System.get_env("AUTH_PASSWORD", "changeme")
|
||||||
|
|
||||||
# config/runtime.exs is executed for all environments, including
|
# config/runtime.exs is executed for all environments, including
|
||||||
# during releases. It is executed after compilation and before the
|
# during releases. It is executed after compilation and before the
|
||||||
|
|||||||
@@ -16,7 +16,7 @@ services:
|
|||||||
retries: 5
|
retries: 5
|
||||||
|
|
||||||
app:
|
app:
|
||||||
build: .
|
image: git.maxboeer.com/schuwi/components-elixir:latest
|
||||||
ports:
|
ports:
|
||||||
- "4000:4000"
|
- "4000:4000"
|
||||||
environment:
|
environment:
|
||||||
@@ -26,6 +26,7 @@ services:
|
|||||||
PHX_SERVER: "true"
|
PHX_SERVER: "true"
|
||||||
PORT: "4000"
|
PORT: "4000"
|
||||||
UPLOADS_DIR: "/data/uploads"
|
UPLOADS_DIR: "/data/uploads"
|
||||||
|
AUTH_PASSWORD: "changeme!"
|
||||||
depends_on:
|
depends_on:
|
||||||
db:
|
db:
|
||||||
condition: service_healthy
|
condition: service_healthy
|
||||||
|
|||||||
Reference in New Issue
Block a user