7. 외부 시스템 연동
이미 사용 중인 클라우드 DB · S3 · AWS 자원도 tidoly에 등록해 두면, tidoly에서 설치한 자원과 같은 방식으로 앱에 연결할 수 있습니다.
외부 자원 등록하기
프로젝트 → External Resources → 등록
등록 과정은 간단합니다.
종류를 선택합니다.
선택한 종류에 맞는 입력 항목이 자동으로 표시됩니다.접속 정보를 입력합니다.
필수 항목과 민감한 정보가 구분되어 표시됩니다.연결 테스트를 합니다.
입력한 주소에 연결할 수 있는지 확인합니다.
민감한 정보는 안전하게 관리합니다
직접 값을 입력하는 대신 이미 클러스터에 있는 Secret을 지정할 수도 있습니다.
민감한 값은 저장한 뒤 화면에 다시 표시되지 않습니다.
키 만료일을 등록하면 만료 30일 전부터 경고를 표시합니다. 필요하다면 키를 발급하거나 갱신하는 방법을 설명하는 문서 링크도 함께 등록할 수 있습니다.
전역으로 등록된 외부 자원도 이 목록에 함께 표시됩니다. 전역 자원에는 전역 표시가 붙습니다.
연결 테스트는 연결 가능 여부만 확인합니다
연결 테스트에서 확인하는 것은 PaaS에서 해당 주소까지 TCP 연결이 가능한지입니다.
아이디나 비밀번호가 올바른지는 확인하지 않습니다.
또한 테스트 요청은 PaaS에서 실행되므로, 실제 앱이 실행되는 Pod의 네트워크 경로까지 확인하는 것은 아닙니다.
화면에도 "소비자 pod egress 미증명" 이라고 표시됩니다.
어디에 등록하나요?
외부 자원을 누가 사용하는지에 따라 등록 위치가 달라집니다.
| 대상 | 등록 위치 |
|---|---|
| 이 프로젝트에서만 사용하는 클라우드 DB (RDS · DocumentDB · ElastiCache 등) | 프로젝트 → External Resources |
| 모든 프로젝트에서 사용하는 외부 자원 | Admin → External Resources |
| S3 · Cloudflare R2 | Admin → Integrations → Object Storage |
| 여러 곳에서 재사용하는 계정 · API 키 | Admin → Credentials |
Admin에 등록한 전역 자원은 사이트 전체에서 공유됩니다.
특히 오브젝트 스토리지는 한 번 등록해 두면 백업이나 파일 저장처럼 스토리지가 필요한 곳에서 선택해서 사용할 수 있습니다.
접속 주소에 비밀번호를 넣지 마세요
user:pass@host처럼 URI에 아이디와 비밀번호를 함께 넣으면 설정 파일에 자격 정보가 평문으로 저장될 수 있습니다.
비밀번호는 URI에 넣지 말고 별도의 Secret 또는 자격 정보로 분리해서 등록하세요.
여러 곳에서 같은 자격을 사용할 때 — Credentials
Credentials는 하나의 자격 정보로 여러 대상을 사용해야 할 때 적합합니다.
예를 들어 레지스트리 자격 하나로 여러 이미지에 접근하는 경우처럼, 대상마다 같은 자격을 반복해서 등록할 필요가 없습니다.
등록한 외부 자원은 어떻게 사용하나요?
외부 자원을 등록해 두면 서비스나 앱을 설치할 때 연결 대상 후보로 나타납니다.
tidoly에서 설치한 자원을 연결할 때와 외부 자원을 연결할 때 사용 방법은 같습니다.
연결 테스트는 통과했는데 앱에서는 연결되지 않나요?
두 테스트의 위치가 다르기 때문일 수 있습니다.
연결 테스트는 PaaS에서 실행되지만 실제 앱은 Pod에서 실행됩니다. 프로젝트는 기본적으로 외부로 나가는 통신이 제한될 수 있으므로, 앱에서 외부 자원으로 나가는 경로도 확인해야 합니다.
메일 발송
알림, 사용자 초대, 앱에서 보내는 메일은 하나의 메일 중계 서버를 통해 처리합니다.
각 서비스마다 메일 서버를 따로 설정하지 않습니다.
메일 서버는 설치할 때 설정하지 않습니다
메일 서버 설정 때문에 서비스 설치가 중단되지 않도록, 메일 중계는 플랫폼에서 한 번만 설정합니다.
설정이 끝나면 메일을 사용하는 서비스가 모두 같은 중계를 이용합니다.
또한 웹메일 화면이 함께 제공되어, 발송된 메일을 브라우저에서 바로 확인할 수 있습니다.
따라서 실제 메일함을 확인하지 않고도 "알림이나 초대 메일이 만들어졌는지" 확인할 수 있습니다.
먼저 메일 중계를 설치합니다
Admin → Operator Install → tidoly Platform
에서 smtp 항목을 설치합니다.
설치할 때 정하는 것은 크기와 발신 주소입니다.
두 가지 모드
| 모드 | 동작 |
|---|---|
| 보관함 모드 | 외부로 메일을 보내지 않고 웹메일 화면에만 보관합니다. |
| 외부 발송 | 기존에 사용하던 메일 서버를 통해 실제 수신자에게 발송합니다. 발송한 메일은 웹메일에서도 확인할 수 있습니다. |
보관함 모드에서는 초대받은 사람이 메일을 받을 수 없습니다
보관함 모드에서는 초대 메일이 외부로 발송되지 않습니다.
중계 서버가 메일을 정상적으로 받아 웹메일 보관함에 저장하기 때문에 발송 과정 자체는 성공한 것으로 처리되며 별도의 오류가 발생하지 않습니다.
팀원을 초대해야 한다면 외부 발송을 먼저 설정하세요.
혼자 사용하거나 사내에서만 사용하는 경우에는 그대로 써도 됩니다
보관함 모드는 외부 메일 서버가 없어도 알림이나 초대 메일이 정상적으로 생성되는지 확인할 수 있습니다.
외부로 메일을 보낼 필요가 없는 개발 환경이나 내부 환경에서도 유용합니다.
다만 보관함에는 비밀번호 재설정 링크나 초대 링크가 그대로 남을 수 있습니다.
웹메일을 외부에 공개한 경우에는 이 링크가 다른 사람에게 노출될 수 있으므로 주의하세요.
외부로 메일을 발송합니다
Admin → Integrations의 메일 카드에서 사용할 메일 서버 정보를 입력합니다.
| 항목 | 설명 |
|---|---|
| 서버 주소 · 포트 | 예: smtp.example.com · 587 |
| 사용자 · 비밀번호 | 인증이 필요하지 않은 서버라면 사용자를 비워 둘 수 있습니다. |
| 발신 주소 | 받는 사람에게 표시되는 발신 주소입니다. |
사용자만 입력하고 비밀번호를 입력하지 않으면 인증에 실패할 수 있습니다.
이미 등록된 서버라면 비밀번호를 비워 두었을 때 기존 비밀번호가 유지됩니다.
외부 발송을 다시 끄려면
보관함 모드로 전환 을 누르면 외부 발송만 중지하고, 메일은 계속 웹메일 보관함에 저장합니다.
특정 도메인은 외부 서버를 거치지 않게 할 수도 있습니다
사내 메일 도메인처럼 외부로 발송할 필요가 없는 주소는 제외 목록에 등록하면 외부 메일 서버를 거치지 않습니다.
다음 → 8. 자원 연결하기