Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
P
puppet-sympa
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Package registry
Container Registry
Model registry
Operate
Environments
Terraform modules
Monitor
Incidents
Service Desk
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Adullact
puppet-sympa
Commits
f6f136a8
Commit
f6f136a8
authored
2 months ago
by
Fabien Combernous
Browse files
Options
Downloads
Patches
Plain Diff
Write first README.md
parent
c850d8e5
No related branches found
Branches containing commit
No related tags found
Tags containing commit
1 merge request
!4
Resolve "gives needed informations in README.md"
Checking pipeline status
Changes
1
Pipelines
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README.md
+23
-21
23 additions, 21 deletions
README.md
with
23 additions
and
21 deletions
README.md
+
23
−
21
View file @
f6f136a8
...
...
@@ -17,41 +17,41 @@ This module install a mailing list server named [Sympa](https://www.sympa.commun
## Setup
### What sympa affects
**OPTIONAL**
### What sympa affects
If it's obvious what your module touches, you can skip this section. For
example, folks can probably figure out that your mysql_instance module affects
their MySQL instances.
With
`manage_user`
at true the module creates a local account on system.
If there's more that they should know about, though, this is the place to
mention:
With
`manage_database`
at true the module installs a PostgreSQL database server and database with role.
*
Files, packages, services, or operations that the module will alter, impact,
or execute.
*
Dependencies that your module automatically installs.
*
Warnings or other important notices.
### Setup Requirements **OPTIONAL**
### Setup Requirements
As a web app, you have to configure a web server. To do so with Puppet, it is possible to use :
*
[
puppetlabs-apache
](
https://forge.puppet.com/modules/puppetlabs/apache/readme
)
*
[
puppet-nginx
](
https://forge.puppet.com/modules/puppet/nginx/readme
)
As backend, PostgreSQL or MySQL/MariaDB are supported. With Puppet, it is possible to use :
*
[
puppetlabs-postgresql
](
https://forge.puppet.com/modules/puppetlabs/postgresql/readme
)
.
*
[
puppetlabs-mysql
](
https://forge.puppet.com/modules/puppetlabs/mysql/readme
)
.
### Beginning with sympa
The very basic steps can be simple
`include sympa`
.
The very basic steps can be simple :
`include sympa`
But it's better to change
`db_password`
at least.
## Usage
Include usage examples for common use cases in the
**Usage**
section. Show your
users how to use your module to solve problems, and be sure to include code
examples. Include three to five examples of the most important or common tasks a
user can accomplish with your module. Show users how to accomplish more complex
tasks that involve different types, classes, and functions working in tandem.
To customize topics :
```
class { 'sympa':
topics => {
'topic1' => {
'en' => 'Topic one in English',
'fr' => 'Cathégorie une en Français',
},
},
}
```
## Reference
...
...
@@ -61,6 +61,8 @@ Details are in [REFERENCE.md](https://gitlab.adullact.net/adullact/puppet-sympa/
Supported OSes are given in
[
metadata.json
](
https://gitlab.adullact.net/adullact/puppet-sympa/-/blob/main/metadata.json
)
file.
This module support only PostgreSQL as backend.
## Development
Home at URL https://gitlab.adullact.net/adullact/puppet-sympa
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment